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INTRODUCTION 



This manual describes the programming features of the UNIX system. It provides nei- 
ther a general overview of the UNIX system nor details of the implementation of the 
system. 

Not all commands, features, and facilities described in this manual are available in 
every UNIX system. The entries not applicable for a particular hardware line will have 
an appropriate caveat stamped in the center of the mast of an entry. Also, programs or 
facilities being phased out will be marked as "Obsolescent" on the top of the entry. 
When in doubt, consult your system's administrator. 

This manual is divided into four sections, some containing inter-filed sub-classes: 

2. System Calls. 

3. Subroutines: 

3C. C and Assembler Library Routines 
3S. Standard I/O Library Routines 
3M. Mathematical Library Routines 
3X. Miscellaneous Routines 
3F. FORTRAN Library Routines 

4. File Formats. 

5. Miscellaneous Facilities. 

Section 2 (System Calls) describes the entries into the UNIX system kernel, including 
the C language interface. 

Section 3 (Subroutines) describes the available subroutines. Their binary versions 
reside in various system libraries in the directories /lib and /usr/lib. See intro(3) for 
descriptions of these libraries and the files in which they are stored. 

Section 4 (File Formats) documents the structure of particular kinds of files; for exam- 
ple, the format of the output of the link editor is given in a.out(4). Excluded are files 
used by only one command (for example, the assembler's intermediate files). In gen- 
eral, the C language struct declarations corresponding to these formats can be found in 
the directories /usr/include and /usr/include/sys. 

Section 5 (Miscellaneous Facilities) contains a variety of things. Included are descrip- 
tions of character sets, macro packages, etc. 

Each section consists of a number of independent entries of a page or so each. The 
name of the entry appears in the upper corners of its pages. Entries within each section 
are alphabetized, with the exception of the introductory entry that begins each section 
(also section 3 is in alphabetical order by suffixes). Some entries may describe several 
routines, commands, etc. In such cases, the entry appears only once, alphabetized 
under its "major" name. 

All entries are based on a common format, not all of whose parts always appear: 

The NAME part gives the name(s) of the entry and briefly states its purpose. 

The SYNOPSIS part summarizes the use of the program being described. A few 
conventions are used, particularly in Section 2 (System Calls): 

Boldface strings are literals and are to be typed just as they appear. 

Italic strings usually represent substitutable argument prototypes and program 
names found elsewhere in the manual (they are underlined in the typed ver- 
sion of the entries) . 

Square brackets [] around an argument prototype indicate that the argument 
is optional. When an argument prototype is given as "name" or "file", it 
always refers to a file name. 
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Ellipses ... are used to show that the previous argument prototype may be 
repeated. 

A final convention is used by the commands themselves. An argument begin- 
ning with a minus — , plus +, or equal sign — is often taken to be some sort of 
flag argument, even if it appears in a position where a file name could appear. 
Therefore, it is unwise to have files whose names begin with — , +, or — . 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) of usage, where appropriate. 

The FILES part gives the file names that are built into the program. 

The SEE ALSO part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that may be produced. 
Messages that are intended to be self-explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiencies. Occasionally, the 
suggested fix is also described. 

A table of contents precedes Section 2. On each index line, the title of the entry to 
which that line refers is followed by the appropriate section number in parentheses. 
This is important because there is considerable duplication of names among the sec- 
tions, arising principally from commands that exist only to exercise a particular system 
call. 

On most systems, all entries are available on-line via the man{\) command (see Sec- 
tion 1 of the UNIX System User Reference Manual) . 

UNIX System V error messages are described in the last section of this manual. 
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2. System Calls 



intro . . • • . . • . . . • ... introduction to system calls and error numbers 
access . . . ... . . . . . . ........ determine accessibility of a file 

acct . . . . . enable or disable process accounting 

alarm . . .... . . .... . ... . . . . . . set a process alarm clock 

brk . . . . . . . . . . . . ... . . . change data segment space allocation 

chdir change working directory 

chmod . change mode of file 

chown change owner and group of a file 

chroot change root directory 

close close a file descriptor 

creat . . . . ... . . create a new file or rewrite an existing one 

dup duplicate an open file descriptor 

exec • • . . .. execute a file 

exit . . . . . . . . . . . . . . . . . . . terminate process 

fcntl . file control 

fork . create a new process 

getpid . . get process, process group, and parent process IDs 

getuid ...... get real user, effective user, real group, and effective group IDs 

ioctl control device 

kill send a signal to a process or a group of processes 

Hnk . . .... . . . . . . . . . .... . . . . . . . . . . link to a file 

lockf . record and file locking 

Iseek move read/write file pointer 

maus .......... multiple-access-user-space (shared memory) operations 

mknod . make a directory, or a special or ordinary file 

mount. .... . . . . . , . . . ... . . .... . . mount a file system 

msgctl . . message control operations 

msgget ........................ . get message queue 

msgop . . . . . . . . .... . . . . message operations 

nice . . . . . . . ... . . . . . . . . . . . . change priority of a process 

open . . . ... . . . . . . . .... . . . . . open for reading or writing 

pause . ... . . V . . . . . . . ... . . . . suspend process until signal 

pipe ... . . ... . . . create an interprocess channel 

plock . . . .... . . . . . . . . . . lock process, text, or data in memory 

profil . . . . . . . . . . . . execution time profile 

ptrace . ......................... . process trace 

read . . ... . . . . ... . .... . read from file 

semctl . . . . . . . . ... ... ... . . . semaphore control operations 

semget . . . . . . get set of semaphores 

semop .............. .... ..... . semaphore operations 

setpgrp . . ... . . . . . . . . . . . ... . ' • . . set process group ID 

setuid ..... . . . . . . . . . . . . ..... . set user and group IDs 

shmctl . . ... . . . . . . . ... . . . shared memory control operations 

shmget . . . . . . . ... . . get shared memory segment 

shmop . . . . . .... . . ... . . . .... . shared memory operations 

signal . . .... . . . . . . . . . specify what to do upon receipt of a signal 

Stat . ... . . . . ... . ... ... . . . . . . . ... get file status 

stime . ....... ..... . . . ...... set time 

sync . ... . . , . . . . . . . . . . . . . . . . . . . update super-block 

time ... . . . . . . ... ... . . . . . ... .... . . . get time 

times . . . .... . . . ...... . . get process and child process times 

uHmit . . . . . . . . ... .... . . . . . . ... get and set user limits 

umask . . . . . . . set and get file creation mask 

umount ....... unmount a file system 

uname .......... . . . . . ... get name of current UNlX system 
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unlink remove directory entry 

ustat get file system statistics 

utime set file access and modification times 

wait wait for child process to stop or terminate 

write write on a file 

3. Subroutines 

intro introduction to subroutines and libraries 

a641 convert between long integer and base-64 ASCII string 

abort generate an lOT fault 

abort terminate Fortran program 

abs return integer absolute value 

abs Fortran absolute value 

acos Fortran arccosine intrinsic function 

aimag Fortran imaginary part of complex argument 

aint Fortran integer part intrinsic function 

asin Fortran arcsine intrinsic function 

assert verify program assertion 

atan Fortran arctangent intrinsic function 

atan2 Fortran arctangent intrinsic function 

bessel Bessel functions 

bool Fortran bitwise boolean functions 

bsearch binary search a sorted table 

clock report CPU time used 

conjg Fortran complex ^conjugate intrinsic function 

conv translate characters 

cos Fortran cosine intrinsic function 

cosh , Fortran hyperbolic cosine intrinsic function 

crypt generate DES encryption 

ctermid generate file name for terminal 

ctime convert date and time to string 

ctype . , classify characters 

curses CRT screen handling and optimization package 

cuserid get character login name of the user 

dial establish an out-going terminal line connection 

dim positive difference intrinsic functions 

dprod double precision product intrinsic function 

drand48 generate uniformly distributed pseudo-random numbers 

ecvt convert floating-point number to string 

end last locations in program 

erf error function and complementary error function 

exp Fortran exponential intrinsic function 

exp exponential, logarithm, power, square root functions 

fclose close or flush a stream 

ferror stream status inquiries 

floor floor, ceiling, remainder, absolute value functions 

fopen open a stream 

fread binary input/output 

frexp , manipulate parts of floating-point numbers 

fseek reposition a file pointer in a stream 

ftw walk a file tree 

ftype explicit Fortran type conversion 

gamma log gamma function 

getarg return Fortran command-line argument 

getc get character or word from a stream 

getcwd . get path-name of current working directory 

getenv return value for environment name 
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getenv return Fortran environment variable 

getgrent get group file entry 

getlogin get login name 

getopt get option letter from argument vector 

getpass read a password 

getpw get name from UID 

getpwent get password file entry 

gets get a string from a stream 

getut access utmp file entry 

hsearch manage hash search tables 

hypot Euclidean distance function 

large large 

index return location of Fortran substring 

13tol convert between 3-byte integers and long integers 

Idahread read the archive header of a member of an archive file 

Idclose close a common object file 

Idfhread read the file header of a common object file 

Idgetname .... retrieve symbol name for common object file symbol table entry 

Idlread manipulate line number entries of a common object file function 

Idlseek seek to line number entries of a section of a common object file 

Idohseek seek to the optional file header of a common object file 

Idopen open a common object file for reading 

Idrseek seek to relocation entries of a section of a common object file 

Idshread read an indexed/named section header of a common object file 

Idsseek seek to an indexed/named section of a common object file 

Idtbindex . . . compute the index of a symbol table entry of a common object file 

Idtbread read an indexed symbol table entry of a common object file 

Idtbseek seek to the symbol table of a common object file 

len return length of Fortran string 

log Fortran natural logarithm intrinsic function 

log 10 Fortran common logarithm intrinsic function 

logname return login name of user 

Isearch linear search and update 

malloc main memory allocator 

malloc fast main memory allocator 

matherr error-handling function 

max Fortran maximum-value functions 

mclock return Fortran time accounting 

memory memory operations 

min Fortran minimum-value functions 

mktemp make a unique file name 

mod Fortran remaindering intrinsic functions 

monitor prepare execution profile 

nlist get entries from name list 

perror system error messages 

plot graphics interface subroutines 

popen initiate pipe to/from a process 

printf print formatted output 

putc put character or word on a stream 

putenv change or add value to environment 

putpwent write password file entry 

puts put a string on a stream 

qsort quicker sort 

rand simple random-number generator 

rand random number generator 

regcmp compile and execute regular expression 

round Fortran nearest integer functions 
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scanf convert formatted input 

setbuf assign buffering to a stream 

setjmp non-local goto 

sign Fortran transfer-of-sign intrinsic function 

signal specify Fortran action on receipt of a system signal 

sin . , Fortran sine intrinsic function 

sinh Fortran hyperbolic sine intrinsic function 

sinh hyperbolic functions 

sleep suspend execution for interval 

sputl access long integer data in a machine-independent fashion. 

sqrt Fortran square root intrinsic function 

ssignal software signals 

stdio standard buffered input/output package 

stdipc standard interprocess communication package 

strcmp string comparision intrinsic functions 

string string operations 

strtod convert string to double-precision number 

strtol . convert string to integer 

swab swap bytes 

system issue a shell command from Fortran 

system issue a shell command 

tan Fortran tangent intrinsic function 

tanh Fortran hyperbolic tangent intrinsic function 

tmpfile create a temporary file 

tmpnam create a name for a temporary file 

trig trigonometric functions 

tsearch manage binary search trees 

ttyname find name of a terminal 

ttyslot ............ find the slot in the utmp file of the current user 

ungetc push character back into input stream 

vprintf print formatted output of a varargs argument list 

vprintf print formatted output of a varargs argument list 

4. File Formats 

intro introduction to file formats 

a.out common assembler and link editor output 

acct per-process accounting file format 

ar common archive file format 

checklist list of file systems processed by fsck 

core format of core image file 

cpio format of cpio archive 

dir format of directories 

errfile error-log file format 

filehdr file header for common object files 

fs format of system volume 

fspec format specification in text files 

gettydefs speed and terminal settings used by getty 

gps graphical primitive string, format of graphical files 

group group file 

inittab script for the init process 

inode format of an i-node 

issue issue identification file 

Idfcn common object file access routines 

linenum line number entries in a common object file 

master master device information table 
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mnttab mounted file system table 

passwd password file 

plot graphics interface 

pnch file format for card images 

profile setting up an environment at login time 

reloc relocation information for a common object file 

sccsfile format of SCCS file 

scnhdr section header for a common object file 

syms common object file symbol table format 

term format of compiled term file. 

terminfo terminal capability data base 

utmp utmp and wtmp entry formats 



5. Miscellaneous Facilities 



intro introduction to miscellany 

ascii map of ASCII character set 

environ user environment 

fcntl file control options 

math math functions and constants 

prof profile within a function 

regexp regular expression compile and match routines 

Stat data returned by stat system call 

term conventional names for terminals 

types primitive system data types 

values machine-dependent values 

varargs handle variable argument list 



Error Messages 
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300: DASI 300 and 300s terminals 300(1) 

terminals. 300: DASI 300 and 300s 300(1) 

300: DASI 300 and 300s terminals 300(1) 

13tol: convert between 3-byte integers and long/ 13tol(3C) 

comparison. diff3: 3-way differential file diff3(l) 

TEKTRONIX 4014 terminal. 4014: paginator for the 4014(1) 

paginator for the TEKTRONIX 4014 terminal. 4014: 4014(1) 

of the DASI 450 terminal. 450: handle special functions . . . 450(1) 

special functions of the DASI 450 terminal. 450: handle 450(1) 

f77: Fortran 77 compiler f77(l) 

integer and base-64 ASCII/ a641: convert between long .... a641(3C) 

abort: generated an lOT fault. . . abort (3C) 

program.- abort: terminate Fortran abort (3F) 

abs: Fortran absolute value. . . . abs(3F) 

value, abs: return integer absolute . . . abs(3C) 

adb: absolute debugger adb(l) 

abs: return integer absolute value abs(3C) 

abs: Fortran absolute value abs(3F) 

/floor, ceiling, remainder, absolute value functions floor (3M) 

requests. accept: allow/prevent LP accept (IM) 

of a file, touch: update access and modification times . . . touch (1) 

utime: set file access and modification times . . . utime(2) 

accessibility of a file, access: determine access(2) 

commands, graphics: access graphical and numerical . . graphics (IG) 

machine-independent/ sputl: access long integer data in a . . . sputl(3X) 

sadp: disk access profiler sadp(lM) 

Idfcn: common object file access routines ldfcn(4) 

copy file systems for optimal access time, dcopy: dcopy(lM) 

getutent: access utmp file entry getut(3C) 

access: determine accessibility of a file access (2) 

acctdisk: overview of accounting acct(lM) 

enable or disable process accounting, acct: acct(2) 

acctconl: connect-time accounting acctcon(lM) 

acctprcl: process accounting acctprc(lM) 

shell procedures for accounting, chargefee: acctsh(lM) 

diskusg: generate disk accounting data by user ID. . . . diskusg(lM) 

acct: per-process accounting file format acct (4) 

search and print process accounting file(s). acctcom: . . . acctcom(l) 

acctmerg: merg or add total accounting files. acctmerg(lM) 

mclock: return Fortran time accounting mclock(3F) 

summary from per-process accounting records, /command . . . acctcras(iM) 

fwtmp: manipulate connect accounting records fwtmp(lM) 

runacct: run daily accounting runacct(lM) 

process accounting, acct: enable or disable acct (2) 

file format. acct: per-process accounting . . . acct (4) 

per-process accounting/ acctcms: command summary from . . . acctcms(lM) 

process accounting file(s). acctcom: search and print acctcom(l) 

accounting, acctconl: connect-time acctcon(lM) 

accounting acctdisk: overview of acct(lM) 

accounting files, acctmerg: merge or add total . . . acctmerg (IM) 
acctprcl: process accounting. . . acctprc(lM) 

intrinsic function, acos: Fortran arccosine . acos(3F) 

killall: kill all active processes killall(lM) 

sag: system activity graph sag(lG) 

sal: system activity report package sar(lM) 

sar: system activity reporter sar(l) 

current SCSS file editing activity, sact: print sact(l) 

report process data and system activity, /time a command: .... timex(l) 
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interface, acu: Automatic Call Unit (ACU) . . acu(7) 

acu: Automatic Call Unit (ACU) interface acu (7) 

adb: absolute debugger adb(l) 

addhd:shell script for add-on disk drive addhd(lM) 

acctmerg: merge or add total accounting files. . . . acctmerg{lM) 

putenv: change or add value to environment putenv(3C) 

sees files. admin: create and administer . . . admin (1) 

admin: create and administer SCCS files admin (1) 

of complex argument, aimag: Fortran imaginary part . . . aimag(3F) 

intrinsic function, aint: Fortran integer part .... aint(3P) 

alarm: set a process alarm clock alarm(2) 

clock, alarm: set a process alarm .... alarm(2) 

brk: change data segment space allocation brk(2) 

malloc: main memory allocator malloc(3C) 

malloc: fastmain memory allocator malloc(3X) 

accept: allow/prevent LP requests accept (IM) 

boolean functions. and, or, xor, not: Fortran .... bool{3F) 

sort: sort and/or merge files sort(l) 

send: gather files and/or submit RJE jobs: send(lC) 

functions, anint: Fortran nearest integer . . round(3F) 

link editor output, a. out: common assembler and .... a.out(4) 

maintainer. ar : archive and library ar(l) 

format, ar: common archive file ar(4) 

language, be: arbitrary-precision arithmetic . . bc(l) 

acos: Fortran arccosine intrinsic function. . . acos(3F) 

for portable archives, ar: archive and library maintainer . . ar(l) 

cpio: format of cpio archive cpio(4) 

ar: common archive file format ar(4) 

archive: archive files to tape archive (1) 

Idahread: read the archive header ldahread{3X) 

tar: tape file archiver tar{l) 

maintainer for portable archives, /archive and library . . ar{l) 

cpio: copy file archives in and out cpio(l) 

asin: Fortran arcsine intrinsic function. . . . asin(3F) 

atan2: Fortran arctangent intrinsic function. . . atan2(3F) 

atan: Fortran arctangent intrinsic function. . . atan(3F) 

imaginary part of complex argument, aimag: Fortran aimag (3F) 

return Fortran command-line argument, getarg: getarg(3F) 

varargs: handle variable argument list varargs(5) 

formatted output of a varags argument list, vprintf : print . . . vprint(3S) 

formatted output of a varargs argument list, vprintf: print . . . vprintf (3X) 

command. xargs: construct argument list(s) and execute . . . xargs(l) 

getopt: get option letter from argument vector getopt(3C) 

expr : evaluate arguments as an expression. . . . expr{l) 

echo: echo arguments echo(l) 

be: arbitrary-precision arithmetic language. bc(l) 

number facts, arithmetic: provide drill in ... arithmetic (6) 

expr: evaluate arguments as an expression expr (1) 

as: common assembler as(l) 

characters, asa: interpret ASA carriage control asa(l) 

control characters, asa: interpret ASA carriage .... asa(l) 

ascii: map of ASCII character set ascii(5) 

set. ascii: map of ASCII character . . . ascii(5) 

long integer and base-64 ASCII string, /convert between . . a641(3C) 

intrinsic function, asin: Fortran arcsine asin(3F) 

help: ask for help help(l) 

output, a. out: common assembler and link editor a. out (4) 

as: common assembler as(l) 

assertion, assert: verify program assert(3X) 

assert: verify program assertion. assert(3X) 
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setbuf : assign buffering to a stream. . . setbuf(3S) 

intrinsic function, atan: Fortran arctangent atan(3F) 

intrinsic function. atan2: Fortran arctangent atan2(3F) 

interface, acu: Automatic Call Unit (ACU) acu(7) 

wait: await completion of process. . . . wait(l) 

processing language, awk: pattern scanning and awk(l) 

ungetc: push character back into input stream ungetc(3S) 

archive: backup to streaming tape archive (1) 

UNIX system file system backup, /daily/weekly filesave(lM) 

fine: fast incremental backup finc(lM) 

free: recover files from a backup tape frec(lM) 

print, initialize, update bad information bdblk: bdblk(lM) 

banner: make posters banner (1) 

terminal capability data base, terminfo: terminfo(4) 

between long integer and base-64 ASCII string, /convert . . a641(3C) 

portions of path names, basename, dirname: deliver .... basename(l) 

arithmetic language, bd: arbitrary-precision bc(l) 

bcopy: interactive block copy. . . bcopy(lM) 

update bad information bdblk: print, initialize, bdblk (IM) 

bdiff: big diff bdiff(l) 

cb: C program beautifier cb(l) 

j0, jl, jn, y0, yl, yn: Bessel functions bessel(3M) 

bfs: big file scanner bfs(l) 

cpset: install object files in binary directories cpset(lM) 

fread: binary input/output f read (33) 

bsearch: binary search a sorted table. . . bsearch(3C) 

tsearch: manage binary search trees . tsearch(3C) 

remove symbols and relocation bits, strip: strip(l) 

bcopy: interactive blofck copy bcopy (IM) 

sum: print checksum and block count of a file sum(l) 

sync: update the super block sync(l) 

df: report number of free disk blocks. df{lM) 

and, or xor, not: Fortran boolean functions bool(3F) 

UNIX system startup and boot procedures, boot: boot (8) 

shell scripts, brc: system initialization .... brc{lM) 

allocation, brk: change data segment space . . brk(2) 

modest-sized programs, bs: a compiler/interpreter for . . bs(l) 

sorted table, bsearch: binary search a bsearch (3C) 

studio: standard buffered input/output package. . . stdio(3S) 

setbuf: assign buffering to a stream setbuf (33) 

mknod: build special file mknod(lH) 

swab: swap bytes swab(3C) 

cc: C compiler cc(l) 

cflow: generate C flow graph cflow(l) 

ccp: the C language preprocessor cpp{l) 

cb: C program beautifier cb(l) 

lint: a C program checker lint(l) 

cxref : generate C program cross-reference. .... cxref (1) 

ctrace: C program debugger ctrace(l) 

cal: print calendar cal(l) 

dc: desk calculator dc(l} 

cal: print calendar cal(l) 

calendar: reminder service. . . . calendar (1) 

cu: call another UNIX system. .... cu(lC) 

data returned by stat system call, stat stat(5) 

acu: Automatic Call Unit (ACU) interface acu (7) 

intro: introduction to system calls and error numbers intro(2) 

link and unlink system calls, link: exercise link(lM) 

to an LP line printer. Ip, cancel: send/cancel requests .. . . lp(l) 

terminfo: terminal capability data base terminfo (4) 
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pnch: file format for card images pnch(4) 

asa: interpret ASA carriage control characters. . . . asa(l) 

files, cat: concatenate and print .... cat(l) 

cb: C program beautifier cb(l) 

cc: C compiler cc(l) 

cd: change working directory. . . cd{l) 

commentary of an SCCS delta, cdc: change the delta cdc(l) 

value/ floor: floor, ceiling, remainder, absolute . . . floor (3M) 

cflow: generate C flow graph. . . cflow(l) 

delta: make a delta (change) to an SCCS file delta (1) 

pipe: create an interprocess channel pipe (2) 

stream, ungetc: push character back into input ungetc(3S) 

user, cuserid: get character login name of the .... cuserid(3S) 

stream, getc: get character or word from a getc(3S) 

putc: put character or word on a stream. . . putc(3S) 

ascii: map of ASCII character set ascii(5) 

interpret ASA carriage control characters, asa: asa (1) 

toupper: translate characters conv(3C) 

isalpha: classify characters ctype(3) 

tr: translate characters tr(l) 

for accounting, chargefee: shell procedures .... acctsh(lM) 

directory, chdir: change working chdir(2) 

fsck: file system consistency check fsck(lM) 

checking procedure, checkall: faster file system . . . checkall{lM) 

lint: a C program checker lint(l) 

pwck: password/group file checkers pwck(lM) 

checkall: faster file system checking procedure checkall (IM) 

copy file systems with label checking, volcopy: volcopy(lM) 

systems processed by fsck. checklist: list of file checklist (4) 

file, sum: print checksum and block count of a . . . sum(l) 

times: get process and child process times times(2) 

terminate, wait: wait for child process to stop or wait (2) 

chmod: change mode chmod(l) 

chmod: change mode of file. . . . chmod (2) 

of a file, chown: change owner and group. . . chown(2) 

chown: change owner or group. . . chown (1) 

chroot: change root directory. . . chroot(2) 

for a command, chroot: change root directory . . . chroot (IM) 

isalpha: classify characters. ....... ctype(3C) 

uuclean: uucp spool directory clean-up uuclean{lM) 

clri: clear i-node clri(lM) 

alarm: set a process alarm clock. alarm(2) 

cron: clock daemon cron(lM) 

clock: report CPU time used. . . . clock (3C) 

Idclose: closes a common object file. . . . ldclose(3X) 

close: close a file descriptor close(2) 

descriptor, close: close a file close(2) 

f close: close or flush a stream. ..... fclose(3S) 

clri: clear i-node clri(lM) 

cmp: compare two files. ..... cmp(l) 

line-feeds, col: filter reverse col (1) 

comb: combine SCCS deltas comb(l) 

comb: combine SCCS deltas comb(l) 

common to two sorted files, comm: select or reject lines . . . comm(l) 

nice: run a command at low priority nice(l) 

change root directory for a command, chroot: chroot (IM) 

env: set environment for command execution env(l) 

uux: UNIX-to-UNIX system command execution (uux(lC) 

system: issue a shell command from Fortran system(3F) 

quits, nohup: run a command immune to hangups and . . . nohup(l) 
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net; execute a command on the PCL network. . . . net(lC) 

getopt: parse command options getopt(l) 

/shellf the standard/restricted command programming language. . . sh(l) 

and system/ timex: time a command; report process data . . . timex(l) 

per-process/ acctcms: command summary from acctcms(lM) 

system: issue a shell command system(3S) 

test: condition evaluation command test(l) 

time: time a command time(l) 

argument list(s) and execute command, xargs: construct xargs(l) 

getarg: return Fortran command-line argument getarg(3F) 

at: execute commands at a later time at(l) 

access graphical and numerical commands, graphics: graphics (IG) 

install: install commands install (IM) 

intro: introduction to commands intro(l) 

introduction to maintenance commands intro: intro (IM) 

network useful with graphical commands, stat: statistical .... stat(lG) 

cdc: change the delta commentary of an SCCS delta. . . . cdc(l) 

ar: common archive file format. . . . ar(4) 

editor output, a. out: common assembler and link ..... a. out (4) 

as: common assembler as(l) 

function. Iogl0: Fortran common logarithm intrinsic .... logl0(3F) 

routines. Idfcn: common object file access ldfcn(4) 

reading. Idopen: open a common object file for ldopen(3X) 

Idclose: close a common object file ldclose(3X) 

read the file header of a common object file. Idfhread: . . . ldfhread(3X) 

seek to the symbol table of a common object file. Idtbseek: . . . ldtbseek(3X) 

line number entries in a common object file, linenum: . . . linenura(4) 

nra: print name list of common object file nm(l) 

relocation information for a common object file, reloc: .... reloc(4) 

scnhdr: section header for a common object file scnhdr{4) 

table format, syms: common object file symbol syms(4) 

filehdr: file header for common object files filehdr(4) 

Id: link editor for common object files ld(l) 

size: print section sizes of common object files size(l) 

comm: select or reject lines common to two sorted files. . . . comm(l) 

ipcs: report inter-process communication facilities/ ipcs(l) 

ftok: standard interprocess communication package stdipc(3C) 

pel: parallel communications link interface. . . pel (7) 

diff: differential file comparator diff(l) 

cmp: compare two files cmp(l) 

SCCS file, sccsdiff: compare two versions of an .... sccsdiff(l) 

functions. Ige: string comparison intrinsic strcmp(3F) 

diff3: 3-way differential file comparison diff3(l) 

dircmp: directory comparison dircmp(l) 

expression, regcmp: compile and execute regular .... regcmp(3X) 

regexp: regular expression compile and match routines. . . . regexp(5) 

regcmp: regular expression compile regcmp(l) 

term: format of compiled term file.. term(4) 

cc: C compiler cc(l} 

f77: Fortran 77 compiler f77(l) 

programs, sec: C compiler for stand-alone scc(l) 

tic: terminfo compiler tic(lH) 

yacc: yet another compiler-compiler. yacc(l) 

modest-sized programs, bs: a compiler/interpreter for bs(l) 

erf: error function and complementary error function. . . erf(3M) 

wait: await completion of process wait(l) 

Fortran imaginary part of complex argument, aimag: ..... aimag(3F) 

function, conjh: Fortran complex conjugate intrinsic .... conjg(3F) 

pack: compress and expand files pack(l) 

table entry of a/ Idtbindex: compute the index of a symbol . . . Idtbindex (3X) 
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cat: concatenate and print files. . . . cat(l) 

test: condition evaluation command ... test(l) 

system, config: configure a UNIX config(lM) 

config: configure a UNIX system. config (IM) 

system. Ipadmin: configure the LP spooling Ipadmin(lM) 

conjugate intrinsic function, conjg: Fortran complex conjg(3F) 

conjg: Fortran complex conjugate intrinsic function. . . conjg (3F) 

fwtmp: manipulate connect accounting records. . . . fwtmp(lM) 

an out-going terminal line connecti®n. dial: establish .... dial(3C) 

acctconl: connect-time accounting acctcon(lM) 

fsck: file system consistency check fsck(lM) 

math: math functions and constants math (5) 

mkfs: construct a file system mkfs{lM) 

execute command, xargs: construct argument list(s) and . . xargs(l) 

Is: list contents of directory ls{l) 

toe: graphical table of contents routines toc(lG) 

csplit: context split csplit(l) 

asa: interpret ASA carriage control characters asa(l) 

ioctl: control device ioctl(2) 

fcntl: file control fcntl(2) 

init: process control initialization init(lM) 

msgctl: message control operations msgctl(2) 

semctl: semaphore control operations semctl(2) 

shmctl : shared memory control operations shmctl(2) 

fcntl: file control options fcntl (5) 

uucp status inquiry and job control, uustat: uustat(lC) 

vc: version control vc(l) 

interface, tty: controlling terminal tty(7) 

terminals, term: conventional names for term(5) 

int: explicit Fortran type conversion ftype(3F) 

units: conversion program units(l) 

dd: convert and copy a file dd(l) 

integers and long/ 13tol: convert between 3-byte 13tol(3C) 

and base-64 ASCII/ a641: convert between long integer . . . a641(3C) 

string, ctime: convert date and time to ctime(3C) 

to string, ecvt: convert floating-point number . . . ecvt(3C) 

scanf: convert formatted input scanf(3S) 

double-precision/ strtod: convert string to strtod(3C) 

strtol: convert string to integer strtol(3C) 

dd: convert and copy a file dd(l) 

bcopy: interactive block copy bcopy(lM) 

cpio: copy file archives in and out. . . cpio(l) 

access time, dcopy: copy file systems for optimal . . . dcopy(lM) 

checking, volcopy: copy file systems with label . . . volcopy(lM) 

cp. In, mv: copy, link or move files cp(l) 

UNIX system to UNIX system copy. uucp: uucp(lC) 

UNIX-to-UNIX system file copy, uuto: public uuto(lC) 

file, core: format of core image .... core(4) 

core: format of core image file core(4) 

mem: core memory mem (7) 

function, cos: Fortran cosine intrinsic . . . cos(3F) 

cosine intrinsic function, cosh: Fortran hyperbolic cosh(3P) 

COS: Fortran cosine intrinsic function cos(3F) 

cosh: Fortran hyperbolic cosine intrinsic function cosh(3F) 

sum: print checksum and block count of a file sum(l) 

wc: word count wc(l) 

files, cp. In, rav: copy, link or move . . cp(l) 

cpio: format of cpio archive cpio (4) 

and out. cpio: copy file archives in ... . cpio(l) 
cpio: format of cpio archive. . . cpio(4) 
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preprocessor, cpp: the C language cpp{l) 

binary directories, cpset: install object files in . . cpset(lM) 

clock: report CPU time used clock (3C) 

crash: examine system images. . . crash (IM) 

system crashes, crash: what to do when the .... crash (8) 

what to do when the system crashes, crash: crash (8) 

rewrite an existing one. creat: create a new file or ... . creat(2) 

file, tmpnam: creat a name for a temporary . . . tmpnam(3S) 

an existing one. creat: create a new file or rewrite . . . creat(2) 

fork: create a new process fork (2) 

In: create a symbolic link ln(l) 

tmpfile: create a temporary file tmpfile(3S) 

channel, pipe: create an interprocess pipe (2) 

files, admin: create and administer SCCS .... admin (1) 

umask: set and get file creation mask umask(2) 

cron: clock daemon cron(lM) 

crontab: user crontab file crontab(l) 

crontab: user crontab file. . . . crontab(l) 

cxref : generate C program cross-reference cxref(l) 

optimization package, curses: CRT screen handling and curses (3X) 

crypt: encode/decode crypt (1) 

encryption, crypt: generate DES crypt (3C) 

csplitt context split csplit(l) 

terminal, ct: spawn getty to a remote .... ct(lC) 

for terminal, ctermid: generate file name .... ctermid(3S) 

to string, ctime: convert date and time . . . ctime{3C) 
ctrace: C program debugger .... ctrace(l) 
cu: call another UNIX system. . . cu{lC) 

activity, sact: print current SCCS file editing sact(l) 

uname: print name of current UNIX system uname(l) 

uname: get name of current UNIX system uname (2) 

slot in the utmp file of the current user, /find the ttyslot(3C) 

getcwd: get path-name of current working directory getcwd(3C) 

and optimization package, curses: CRT screen handling .... curses (3X) 

spline: interpolate smooth curve spline (IG) 

name of the user, cuserid: get character login . . . cuserid(3S) 

of each line of a file, cut: cut out selected fields . . . cut(l) 

each line of a file, cut: cut out selected fields of .... cut(l) 

cross-reference, cxref: generate C program cxref (1) 

cron: clock daemon cron(lH} 

errdemon: error-logging daemon errdemon(lM) 

terminate the error-logging daemon, errstop: errstop(lM) 

runacct: run daily accounting . runacct(lM) 

system backup, filesave: daily/weekly UNIX system file . . . filesave{lM) 

300: D^SI 300 and 300s terminals. ... 300(1) 

special functions of the DASI 450 terminal, /handle .... 450(1) 

/time a command; report process data and system activity timex(l) 

terminfo: terminal capability data base terminfo(4) 

generate disk accounting data by user ID. diskusg: .... diskusg(lM) 

sputl: access long integer data in a machine- independent/ . . sputl(3X) 

plock: lock process, text, or data in memory plock(2) 

prof: display profile data prof(l) 

call. Stat: data returned by stat system . . . stat(5) 

brk: change data segment space allocation. . . brk(2) 

types: primitive system data types types (5) 

join: relational database operator join(l) 

tput: query terminfo database tput(l) 

ctime: convert date and time to string ctime (3C) 

date: print and set the date date(l) 

date: print and set the date. . . date(l) 
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dc: desk calculator dc(l) 

optimal access time, dcopy: copy file systems for . . . dcopy(lM) 

dd: convert and copy a file. . . . dd(l) 

/link with built-in DDCMP protocol dmc(7) 

adb: absolute debugger. . adb(l) 

ctrace: C program debugger ctrace{l) 

fsdb: file system debugger fsdb(lM) 

sdb: symbolic debugger sdb{l) 

sysdef : system definition sysdef(lM) 

names, basename, dirname: deliver portions of path basename(l) 

file, tail: deliver the last part of a .... tail(l) 

delta commentary of an SCCS delta, cdc: change the cdc(l) 

file, delta: make a delta (change) to an SCCS delta(l) 

delta, cdc: change the delta commentary of an SCCS .... cdc{l) 

rmdel: remove a delta from an SCCS file rmdel(l) 

to an sees file, delta: make a delta (change) . . . delta(l) 

comb: combine SCCS deltas comb(l) 

mesg: permit or deny messages mesg(l) 

crypt: generate DES encryption crypt (3C) 

close: close a file descriptor close(2) 

dup: duplicate an open file descriptor dup(2) 

dc: desk calculator. dc(l) 

file, access: determine accessibility of a ... access (2) 

file: determine file type file(l) 

master: master device information table master (4) 

ioctl: control device ioctl(2) 

devnm: device name devnm(lM) 

hpd: graphical device routines and filters. . . . gdev(lG) 

devnm: device name devnm (IM) 

blocks, df: report number of free disk . . df(lM) 

terminal line connection, dial: establish an out-going . . . dial(3C) 

ratfor: rational Fortran dialect ratfor(l) 

bdiff: big diff bdiff(l) 

comparator, diff: differential file diff(l) 

comparison. diffS: 3-way differential file . . diff3(l) 

functions, dim: positive difference intrinsic dim(3F) 

sdiff: side-by-side difference program sdiff(l) 

diffmk:mark differences between files diffrak(l) 

diff: differential file comparator. . . diff(l) 

diff3: 3-way differential file comparison. . . diff3(l) 

between files, diffmk: mark differences diffmk(l) 

intrinsic functions, dim: positive difference dim(3F) 

dir: format of directories. . . . dir(4) 

dircmp: directory comparison. . . dircmp(l) 

install object files in binary directories, cpset: cpset(lM) 

dir: format of directories dir(4) 

rm: remove files or directories rm(l) 

cd: change working directory cd{l) 

chdir: change working directory chdir(2) 

chroot: change root directory chroot(2) 

uuclean: uucp spool directory clean-up. uuclean(lM) 

dircmp: directory comparison dircmp(l) 

unlink: remove directory entry unlink (2) 

chroot: change root directory for a command chroot (IM) 

path-name of current working directory, getcwd: get getcwd(3C) 

Is: list contents of directory ls(l) 

mkdir: make a directory mkdir(l) 

mvdir: move a directory . ravdir(lM) 

pwd: working directory name pwd(l) 

ordinary file, mknod: make a directory, or a special or .... mknod(2) 
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path names, basename, dirname: deliver portions of ... basenanie(l) 

acct: enable or disable process accounting. . . . acct(2) 

type, modes, speed, and line discipline, /set terminal getty{lM) 

sadp: disk access profiler sadp(lM) 

ID. diskusg: generate disk accounting data by user . . . diskusg(lM) 

df: report number of free disk blocks df(lM) 

general driver for moving-head disks, gd: gd(7) 

accounting data by user ID. diskusg: generate disk diskusg (IM) 

mount: mount and dismount file system mount (IM) 

cpu: display local system name cpu(l) 

netstat: display network system status. . . netstat(l) 

prof: display profile data prof (1) 

hypot: Euclidean distance function hypot{3M) 

drand48: generate uniformly distributed pseudo- random/ .... drand48(3C) 

whodo: who is doing what whodo(lM) 

intrinsic function, dprod: double precision product dprod{3F) 

strtod: convert string to double-precision number strtod(3C) 

product intrinsic function, dprod: double precision dprod (3F) 

distributed pseudo- random/ drand48: generate uniformly .... drand48(3C) 

graph: draw a graph graph (IG) 

gd: general driver for moving-head disks. . . gd(7) 

gt: general driver for tape drives gt(7) 

sxt: pseudo-device driver sxt(7) 

trace: event-tracing driver trace (7) 

gt: general driver for tape drives gt(7) 

an object file, dump: dump selected parts of ... dump(l) 

extract error records from dump, errdead: errdead(lM) 

od: octal dump od(l) 

object file, c^ump: dump selected parts of an dump(l) 

descriptor, dup: duplicate an open file .... dup(2) 

descriptor, dup: duplicate an open file dup (2) 

echo: echo arguments echo(l) 

echo: echo arguments echo(l) 

number to string, ecvt: convert floating-point . . . ecvt(3C) 

ed, red: text editor ed(l) 

edit: text editor edit(l) 

sact: print current SCCS file editing activity sact(l) 

ed, red: text editor ed(l) 

edit: text editor edit(l) 

ex: text editor ex(l) 

files. Id: link editor for common object ld(l) 

ged: graphical editor get(lG) 

Id: link editor ld(l) 

common assembler and link editor output, a. out: a.out(4) 

sed: stream editor sed(l) 

vi: screen-oriented editor vi(l) 

Language. e£l: Extended Fortran efl(l) 

f split: split F77, ratfor, or efl files fsplit(l) 

printers, enable: enable/disable LP enable (1) 

accounting, acct: enable or disable process acct (2) 

enable: enable/disable LP printers. . . . enable(l) 

crypt: encode/decode crypt (1) 

crypt: generate DES encryption crypt (3C) 

makekey: generate encryption key makekey(l) 

program, end: last locations in end(3C) 

trenter: enter a trouble report trenter(l) 

nlist: get entries from name list nlist(3C) 

file, linenum: line number entries in a common object .... linenum(4) 

man: print entries in this manual raan(l) 

/manipulate line number entries of a file function. . . . ldlread(3X) 
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Idlseek: seek to line number entries of a section of a/ .... ldlseek(3X) 

Idrseek: seek to relocation entries of a section of a/ .... ldrseek(3X) 

utmp; utmp and wtmp entry formats utnip(4) 

getgrent: get group file entry getgrent(3C) 

getpwent: get password file entry getpwent(3C) 

getutent: access utmp file entry getut(3C) 

name for file symbol table entry, /retrieve symbol Idgetname (3X) 

the index of a symbol table entry of a file, /compute Idtbindex (3X) 

read an indexed symbol table entry of a file. Idtbread: .... ldtbread{3X) 

putpwent: write password file entry putpwent(3C) 

unlink: remove directory entry unlink (2) 

command execution. env: set environment for env(l) 

environ: user environment. .... environ{5) 

profile: setting up an environment at login time profile (4) 

environ: user environment environ(5) 

execution, env: set environment for command env(l) 

getenv: return value for environment name getenv(3C) 

putenv: change or add value to environment putenv(3C)) 

get: return Fortran environment variable getenv (3F) 

complementary error function, erf: error function and erf(3M) 

err: error-logging interface. . . err (7) 

from dump, errdead: extract error records . . errdead(lM) 

daemon, errdemon: error-logging errdemon{lM) 

format, errfile: error-log file errfile{4) 

debugging, serverdaemon: error analysis and network .... serverdaemon(I 

complementary error/ erf: error function and erf(3M) 

function and complementary error function, erf: error .... erf (3M) 

perror: system error messages perror(3C) 

to system calls and error numbers, /introduction . . . intro(2) 

errdead: extract error records from dump errdead (IM) 

matherr: error-handling function raatherr(3M) 

errfile: error-log file format errfile(4) 

errdemon: error-logging daemon errdemon (IM) 

errstop: terminate the error-logging daemon errstop(lM) 

err: error-logging interface err(7) 

process a report of logged errors, errpt: errpt(lM) 

spell: find spelling errors spell (1) 

logged errors, errpt: process a report of .... errpt (IM) 

error-logging daemon, errstop: terminate the errstop(lM) 

terminal line/ dial: establish an out-going dial(3C) 

setmnt: establish mount table setmnt(lM) 

hypot: Euclidean distance function. . . . hypot{3M) 

expression, expr: evaluate arguments as an expr(l) 

test: condition evaluation command test(l) 

trace: event-tracing driver trace (7) 

ex: text editor. ex(l) 

crash: examine system images crash (IM) 

execl: execute a file . exec (2) 

network, net: execute a command on the PCL . . . net(lC) 

execl: execute a file exec (2) 

netlet: execute command on remote system . netlet(l) 

construct argument list(s) and execute command, xargs: xargs(l) 

time, at: execute commands at a later . . . . at(l) 

regcmp: compile and execute regular exptession. . . . regcmp(3X) 

set environment for command execution, env: env(l) 

sleep: suspend execution for an interval sleep (1) 

sleep: suspend execution for interval sleep (3C) 

monitor: prepare execution profile monitor (3C) 

profil: execution time profile profil(2) 

UNIX-to-UNIX system command execution, uux: .... uux(lC) 
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system calls, link: exercise link and unlink link{lM) 

a new file or rewrite an existing one. creat: create .... creat(2) 

exit: terminate process exit(2) 

power, square root functions, exp: exponential, logarithm, . . . exp(3M) 

intrinsic function, exp: Fortran exponential ..... exp(3F) 

pack: compress and expand files pack(l) 

conversion, int: explicit Fortran type ftype(3F) 

function, exp: Fortran exponential intrinsic exp(3F) 

square root functions, exp: exponential, logarithm, power . . . exp(3M) 

expression, expr: evaluate arguments as an . . expr(l) 

routines, regexp: regular expression compile and match . . . regexp(5) 

regcmp: regular expression compile regcmp{l) 

expr: evaluate arguments as an expression expr(l) 

compile and execute regular expression, regcmp: regcmp(3X) 

efl: Extended Fortran Language efl(l) 

dump, errdead: extract error records from .... errdead(lM) 

til'. Fortran 77 compiler f77(l) 

factor: factor a number. .... factor (1) 

factor: factor a number factor (1) 

data in a machine-independent fashion /access long integer . . . sputl{3X) 

fine: fast incremental backup finc(lM) 

malloc: fast main memory allocator. . . . malloc(3X) 

procedure, checkall: faster file system checking . . , checkall(lM) 

abort: generate an lOT fault abort(3C) 

stream, fclose: close or flush a fclose(3S) 

fcntl: file control fcntl{2) 

fcntl: file control options. . . . fcntl (5) 

inquiries. ferror: stream status ferror(3S) 

statistics for a file system, ff: list file names and ff(lM) 

times, utime: set file access and modification . . . utime(2) 

Idfcn: common object file access routines ldfcn{4) 

determine accessibility of a file, access: access(2) 

tar: tape file archiver tar(l) 

cpio: copy file archives in and out cpio(l) 

pwck: password/group file checkers pwck(lM) 

chmod: change mode of file chmod(2) 

change owner and group of a file, chown: chown(2) 

diff: differential file comparator diff(l) 

diff3: 3-way differential file comparison diff3(l) 

fcntl: file control fcntl (2) 

fcntl: file control options fcntl (5) 

public UNIX-to-UNIX system file copy, uuto: uuto(lC) 

core: format of core image file core{4) 

umask: set and get file creation mask umask(2) 

crontab: user crontab file crontab(l) 

fields of each line of a file, cut: cut out selected . . . cut(l) 

dd: convert and copy a file dd(l) 

a delta (change) to an SCCS file, delta: make delta(l) 

close: close a file descriptor close(2) 

dup: duplicate an open file descriptor dup(2) 

file: determine file type file(l) 

selected parts of an object file, dupm: dump dump(l) 

sact: print current SCCS file editing activity sact(l) 

getgrent: get group file entry getgrent(3C) 

getpwent: get password file entry getpwent(3C) 

getutent: access utmp file entry getut(3C) 

putpwent: write password file entry putpwent(3C) 

execl: execute a file exec (2) 

grep: search a file for a pattern grep(l) 

Idopen: open a common object file for reading ldopen(3X) 
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acct: per-process accounting file 

ar: common archive file 

errfile: error-log file 

pnch: file 

intro: introduction to file 

line number entries of a file 

get: get a version of an SCCS file. 

group: group file, 

files, filehdr: file 

file. Idfhread: read the file 

Idohseek: seek to the optional file 

split: split a file 

issue: issue identification file. 

Idclose: close a common object file, 

file header of a common object file, 

entries of a section of a file, 

the optional file header of a file, 

entries of a section of a file, 

section header of a file, 

section of an object file, 

of a symbol table entry of a file, 

symbol table entry of a file, 

table of a common object file, 

entries in a common object file. 

lockf : record and file 

link: link to a file, 

mknod: build special file, 

or a special or ordinary file, 

ctermid: generate file 

mkterap: make a unique file 

a file system, ff: list file 

change the format of a text file, 

name list of common object file. 

null: the null file, 

/find the slot in the utmp file 

/identify processes using a file 

one. creat: create a new file 

passwd: password file, 

merge same lines of several file 

soft-copy terminals, pg: file 

fseek: reposition a file 

Iseek: move read/write file 

prs: print an SCCS file, 

read: read from file, 

for a common object file, 

remove a delta from an SCCS file. 

bfs: big file 

two versions of an SCCS file, 

sccsfile: format of SCCS file, 

header for a common object file. 

Stat: get file 

line number information from a file, 

processes using a file or file 

checksum and block count of a file, 

/retrieve symbol name for file 

syms: common object file 

daily/weekly UNIX system file 

procedure, checkall: faster file 

fsck: file 

fsdb: file 



format acct (4) 

format ar(4) 

format errfile(4) 

format for card images. . . . pnch (4) 

formats intro(4) 

function, /manipulate .... ldlread(3X) 

. get(l) 

group(4) 

header for common object . . . filehdr (4) 
header of a common object . . Idfhread (3X) 

header of a file Idohseek (3X) 

into pieces split(l) 

issue(4) 

ldclose(3X) 

Idfhread; read the Idfhread (3X) 

/seek to line number .... Idlseek (3X) 

Idohseek: seek to Idohseek {3X) 

/seek to relocation ldrseek(3X) 

/read an indexed/named . . . ldshread(3X) 
/to an indexed/named .... ldsseek(3X) 
/compute the index ..... Idtbindex (3X) 

/read an indexed ldtbread(3X) 

/seek to the symbol Idtbseek (3X) 

linenum: line number .... linenum(4) 

locking lockf (2) 

link (2) 

mknod (IM) 

/make a directory, mknod (2) 

name for terminal ctermid (3S) 

name mktemp(3C) 

names and statistics for . . . ff(lM) 

newform: newform(l) 

nm: print nm(l) 

null(7) 

of the current user ttyslot(3C) 

or file structure fuser(lM) 

or rewrite an existing .... creat(2) 

passwd (4) 

paste: paste(l) 

perusal filter for pg(l) 

pointer in a stream fseek (3S) 

pointer Iseek (2) 

prs(l) 

read (2) 

/relocation information . . . reloc(4) 

rrodel : rmdel(l) 

scanner bfs(l) 

sccsdiff: compare sccsdiff(l) 

sccsfile(4) 

scnhdr: section scnhdr(4) 

status Stat (2) 

strip: strip symbol and . . . strip(l) 

structure, /identify fuser(lM) 

sum: print sum(l) 

symbol table entry Idgetname (3X) 

symbol table format syms (4) 

system backup, filesave: . . . filesave(lM) 

system checking checkall (IM) 

system consistency check . . . fsck(lM) 

system debugger fsdb(lM) 
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names and statistics for a file system, ff: list file .... ff(lM) 

volume, file system: format of system . . . fs(4) 

mkfs: construct a file system rakfs(lM) 

mount: mount and dismount file system mount (IM) 

mount: mount a file system mount (2) 

ustat: get file system statistics ustat(2) 

mnttab: mounted file system table ranttab(4) 

umount: unmount a file system umount(2) 

access time, dcopy: copy file systems for optimal dcopy(lM) 

fsck. checklist: list of file systems processed by checklist(4) 

checking, volcopy: copy file systems with label volcopy(lM) 

deliver the last part of a file, tail: tail{l) 

term: format of compiled term file term(4) 

tmpfile: create a temporary file tmpfile(3S) 

create a name for a temporary file, tmpnam: tmpnam{3S) 

and modification times of a file, touch: update access .... touch (1) 

ftw: walk a file tree ftw(3C) 

file: determine file type file(l) 

undo a previous get of an SCCS file, unget: unget(l) 

report repeated lines in a file, uniq: uniqd) 

val: validate SCCS file val(l) 

write: write on a file write(2) 

umask: set file-creation mode mask umask(l) 

common object files, filehdr: file header for filehdr(4) 

and print process accounting file(s). acctcom: search acctcom(l) 

merge or add total accounting files, acctmerg: acctmerg(lM) 

create and administer SCCS files, admin: admin (1) 

cat: concatenate and print files cat{l) 

cmp: compare two files cmp(l) 

lines common to two sorted files, comm: select or reject . . . comm(l) 

cp, In, mv: copy, link or move files cp(l) 

mark differences between files, diffmk diffmk(l) 

file header for common object files, filehdr: filehdr (4) 

find: find files find(l) 

free: recover files from a backup tape frec(lM) 

format specification in text files, fspec: fspec(4) 

split f77, ratfor, or elf files, fsplit: fsplitd) 

string, format of graphical files, /graphical primitive .... gps(4) 

cpset: install object files in binary directories. . . . cpset{lM) 

intro: introduction to special files intro(7) 

link editor for common object files. Id: ld{l) 

rm: remove files or directories rm(l) 

pack: compress and expand files pack(l) 

pr: print files pr(l) 

section sizes of common object files, size: print size(l) 

sort: sort and/or merge files sort(l) 

what: identify SCCS files what(l) 

system file system backup, filesave: daily/weekly UNIX .... filesave(lM) 

terminals, pg: file perusal filter for soft-copy pg(l) 

greek: select terminal filter greek (1) 

nl: line numbering filter nl(l) 

col: filter reverse line-feeds col{l) 

graphical device routines and filters, hpd: gdev(lG) 

tplot: graphics filters tplot(lG) 

fine: fast incremental backup. . . finc(lM) 

find: find files find(l) 

find: find files find(l) 

ttyname: find name of a terminal ttyname(3C) 

object library, lorder: find ordering relation for an . . . lorder(l) 

spell: find spelling errors spell(l) 
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of the current user, ttyslot: find the slot in the utmp file . . ttyslot(3C) 

tee: pipe fitting tee(l) 

string, ecvt: convert floating-point number to ecvt(3C) 

frexp: manipulate parts of floating-point numbers frexp(3C) 

absolute value/ floor: floor, ceiling, remainder floor (3M) 

remainder, absolute value/ floor: floor, ceiling, . floor (3M) 

cflow: generate C flow graph cflow(l) 

fclose: close or flush a stream fclose(3S) 

fopen: open a stream fopen(3S) 

fork: create a new process. . . . fork (2) 

per-process accounting file format, acct: acct(4) 

RM05 disk packs, format: format and/or check RP06 and . . . format(lM) 

ar: common archive file format ar(4) 

errfile: error-log file format errfile(4) 

pnch: file format for card images pnch(4) 

format: format floppy disk drive format(lM) 

newform: change the format of a text file newform(l) 

inode: format of an i-node inode(4) 

term: format of compiled term file. . . term(4) 

core: format of core image file core{4) 

cpio: format of cpio archive cpio(4) 

dir: format of directories dir(4) 

/graphical primitive string, format of graphical files gps(4) 

sccsfile: format of SCCS file sccsfile(4) 

file system: format of system volume fs(4) 

files, fspec: format specification in text . . . fspec(4) 

object file symbol table format, syms: common syms(4) 

intro: introduction to file formats intro(4) 

utmp: utmp and wtmp entry formats utmp (4) 

scanf: convert formatted input scanf(3S) 

argument list, vprintf: print formatted output of a varargs . . . vprintf (3S) 

argument list, vprintf: print formatted output of a varargs . . . vprintf (3X) 

printf: print formatted output printf(3S) 

f77: Fortran 77 compiler f77(l) 

abs: Fortran absolute value abs{3F) 

system/ signal: specify Fortran action on receipt of a . . signal (3F) 

function, acos: Fortran arccosine intrinsic .... acos(3F) 

function, asin: Fortran arcsine intrinsic asin(3F) 

function. atan2: Fortran arctangent intrinsic . . . atan2(3F) 

function, atan: Fortran arctangent intrinsic . . . atan(3F) 

and, or, xor, not: Fortran boolean functions bool(3F) 

getarg: return Fortran command-line argument. . . getarg(3F) 

intrinsic function. Iogl0: Fortran common logarithm ..... logl0(3F) 

intrinsic function, conjg: Fortran complex conjugate conjg(3F) 

function, cos: Fortran cosine intrinsic cos(3F) 

ratfor: rational Fortran dialect. ratfor(l) 

getenv: return Fortran environment variable. . . getenv(3F) 

function, exp: Fortran exponential intrinsic . . . exp(3F) 

intrinsic function, cosh: Fortran hyperbolic cosine cosh(3F) 

intrinsic function, sinh: Fortran hyperbolic sine sinh(3F) 

intrinsic function, tanh: Fortran hyperbolic tangent .... tanh(3F) 

complex argument, aimag: Fortran imaginary part of aimag(3F) 

function, aint: Fortran integer part intrinsic . . aint(3F) 

efl: Extended Fortran Language efl(l) 

functions, max: Fortran maximum-value max(3F) 

functions, min: Fortran minimum-value min(3F) 

intrinsic function, log: Fortran natural logarithm log(3F) 

function, anint: Fortran nearest integer round (3F) 

abort: terminate Fortran program abort(3F) 

functions, mod: Fortran remaindering intrinsic . . mod(3F) 
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function, sin: Fortran sine intrinsic sin(3F) 

function, sqrt: Fortran square root intrinsic . . . sqrt(3F) 

len: return length of Fortran string len(3F) 

index: return location of Fortran substring index (3F) 

issue a shell command from Fortran, system: system(3F) 

function, tan: Fortran tangent intrinsic tan(3F) 

mclock: return Fortran time accounting mclock(3F) 

intrinsic function, sign: Fortran transf er-of-sign sign(3F) 

int: explicit Fortran type conversion ftype(3F) 

fread: binary input/output. . . . fread(3S) 

backup tape, free: recover files from a .... frec(lM) 

df: report number of free disk blocks df(lM) 

floating-point numbers, frexp: manipulate parts of .... frexp(3C) 

free: recover files from a backup tape frec(lM) 

and line number information from a file, /strip symbol .... strip(l) 

getc: get character or word from a stream getc(3S) 

gets: get a string from a stream gets(3S) 

rmdel: remove a delta from an SCCS file rmdel{l) 

getopt: get option letter from argument vector getopt(3C) 

errdead: extract error records from dump errdead(lM) 

read: read from file read(2) 

system: issue a shell command from Fortran system(3F) 

ncheck: generate names from i-numbers ncheck(lM) 

nlist: get entries from name list nlist(3C) 

acctcms: command summary from per-process accounting/ . . . acctcms(lM) 

getpw: get name from UID getpw(3C) 

of file systems processed by fsck. checklist: list checklist (4) 

check fsck: file system consistency . . . fsck(lM) 
fsdb: file system debugger. . . . fsdb(lM) 

pointer in a stream fseek: reposition a file fseek(3S) 

text files fspec: format specification in . . f spec (4) 

efl files. fsplit: split til, ratfor, or . . . fsplit(l) 

communication package, ftok: standard interprocess .... stdipc(3C) 

ftw: walk a file tree ftw(3C) 

Fortran arccosine intrinsic function, acos: acos(3F) 

Fortran integer part intrinsic function, aint: aint(3F) 

error function, erf: error function and complementary .... erf(3M) 

Fortran arcsine intrinsic function, asin: asin(3F) 

Fortran arctangent intrinsic function. atan2: atan2(3F) 

Fortran arctangent intrinsic function, atan: atan(3F) 

complex conjugate intrinsic function, conjug: Fortran conjg(3F) 

cos: Fortran cosine intrinsic function cos(3F) 

hyperbolic cosine intrinsic function, cosh: Fortran cosh(3F) 

precision product intrinsic function, dprod: double dprod(3F) 

and complementary error function, erf: error function . . . erf {3M) 

Fortran exponential intrinsic function, exp: exp(3F) 

gamma: log gamma function gamma (3H) 

hypot: Euclidean distance function hypot(3M) 

line number entries of a file function. Idlread: manipulate . . . ldlread(3X) 

common logarithm intrinsic function. Iogl0: Fortran logl0(3F) 

natural logarithm intrinsic function, log: Fortran log(3F) 

matherr: error-handling function matherr(3M) 

prof: profile within a function prof (5) 

transf er-of-sign intrinsic function, sign: Fortran sign(3F) 

sin: Fortran sine intrinsic function sin(3F) 

hyperbolic sine intrinsic function, sinh: Fortran sinh(3F) 

Fortran square root intrinsic function, sqrt: sqrt(3F) 

tan: Fortran tangent intrinsic function tan(3F) 

hyperbolic tangent intrinsic function, tanh: Fortran tanh(3F) 

math: math functions and constants math (5) 
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j0, jl, jn, y0, yn: Bessel functions bessel(3M) 

or, xor, not: Fortran boolean functions, and, bool(3F) 

positive difference intrinsic functions, dim: dim(3F) 

logarithm, power, square root functions, exp: exponential, . . . exp(3M) 

remainder, absolute value functions, /floor, ceiling, .... floor(3M) 

max: Fortran maximum-value functions max(3F) 

min: Fortran minimum-value functions min(3F) 

Fortran remaindering intrinsic functions, mod: mod(3F) 

hp: handle special functions of HP terminals hp(l) 

terminal. 450: handle special functions of the DASI 450 450(1) 

anint: Fortran nearest integer functions round (3F) 

sinh: hyperbolic functions sinh(3M) 

string comparison intrinsic functions. Ige: strcmp(3F) 

sin: trigonometric functions. . . ^ trig(3M) 

using a file or file/ fuser: identify processes fuser(lM) 

accounting records, fwtmp: manipulate connect fwtmp(lM) 

gamma: log gamma function gamma (3M) 

gamma: log gamma function gamma (3M) 

moving-head disks, gd: general drive for gd(7) 

ged: graphical editor get(lG) 

abort: generate an lOT fault abort(3C) 

cflow: generate C flow graph cflow(l) 

cross-reference, cxref: generate C program cxref(l) 

crypt: generate DES encryption crypt (3C) 

by user ID. diskusg: generate disk accounting data . . . diskusg(lM) 

makekey: generate encryption key makekey(l) 

terminal, ctermid: generate file name for ...... ctermid(3S) 

ncheck: generate names from i-numbers. . . ncheck(lM) 

lexical tasks, lex: generate programs for simple . . . lex(l) 

pseudo- random/ drand48: generate uniformly distributed . . drand48(3C) 

rand: simple random-number generator rand(3C) 

irand: random number generator rand(3F) 



gets: get a string from a stream .... gets(3S) 
get: get a version of an SCCS file. . . get(l) 



ulimit: get and set user limits ulimit{2) 

the user, cuserid: get character login name of ... . cuserid{3S) 

stream, getc: get character or word from a ... getc(3S) 

nlist: get entries from name list. . . , nlist(3C) 

umask: set and get file creation mask umask(2) 

Stat: get file status stat(2) 

ustat: get file system statistics. . . . ustat(2) 

file, get: get a version of an SCCS . . . get(l) 

getgrent: get group file entry getgrent(3C) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

msgget: get message gueue msgget(2) 

getpw: get name from UID getpw(3C) 

system, uname: get name of current UNIX uname(2) 

unget: undo a previous get of an SCCS file unget(l) 

argument vector, getopt: get option letter from getopt(3C) 

getpwent: get password file entry getpwent(3C) 

working directory, getcwd: get path-name of current getcwd(3C) 

times, times: get process and child process . . . times (2) 

and parent process/ getpid: get process, process group,.. . . . getpid(2) 

semget: get set of semaphores semget(2) 

shmget: get shared memory segment shmget(2) 

tty: get the name of the terminal. . . tty(l) 

time: get time time(2) 

getuid: get user IDs getuid(2) 

command-line argument, getarg: return Fortran getarg(3F) 
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from a stream, getc: get character or word .... getc(3S) 

current working directory, getcwd: get path-name of getcwd(3C) 

environment variable, getenv: return Fortran getenv(3F) 

environment name, getenv: return value for getenv (3C) 

entry, getrent; get group file getgrent(3C) 

getlogin: get login name getlogin(3C) 

argument vector, getopt: get option letter from . . getopt(3C) 

getopt: parse command options. . . getopt (1) 

getpass: read a password getpass(3C) 

group, and parent process/ getpid: get process, process . . . getpid(2) 

getpw: get name from UID getpw(3C) 

entry, getpwent: get password file .... getpwent(3C) 

stream, gets: get a string from a gets(3S) 

and terminal settings used by getty. gettydefs: speed gettydefs(4) 

modes, speed, and line/ getty: set terminal type, getty (IM) 

ct: spawn getty to a remote terminal. . . . ct(lC) 

settings used by getty. gettydefs: speed and terminal . . . gettydefs (4) 

getuid: get user IDs getuid(2) 

entry, getutent: access utmp file .... getut(3C) 

setjmp: non-local goto setjmp(3C) 

string, format of graphical/ gps: graphical primitive gps(4) 

cflow: generate C flow graph cflow{l) 

graph: draw a graph graph(lG) 

graph: draw a graph graph (IG) 

sag: system activity graph sag(lG) 

commands, graphics: access graphical and numerical graphics (IG) 

/network useful with graphical commands stat(lG) 

filters, hpd: graphical device routines and . . . gdev(lG) 

ged: graphical editor ged(lG) 

primitive string, format of graphical files, /graphical .... gps (4) 

format of graphical/ gps: graphical primitive string, . . . gps{4) 

routines, toe: graphical table of contents .... toc(lG) 

gutil: graphical utilities gutil(lG) 

numerical commands, graphics: access graphical and . . graphics (IG) 

tplot: graphics filters tplot(lG) 

plot: graphics interface plot(4) 

subroutines, plot: graphics interface plot(3X) 

greek: select terminal filter . . . greek (1) 

pattern, grep: search a file for a grep(l) 

getpid: get process, process group, and parent process IDs. . . getpid(2) 

chown: change owner or group chown(l) 

getgrent: get group file entry getgrent(3C) 

group: group file group(4) 

group: group file group(4) 

setgrp: set process group ID setpgrp(2) 

id: print user and group IDs and names id(l) 

setuid, setgid: set user and group IDs setuid(2) 

newgrp: log in to a new group newgrp(l) 

chown: change owner and group of a file chown (2) 

a signal to a process or a group of processes, /send kill(2) 

update, and regenerate groups of programs, /maintain, . . make(l) 

drives, gt: general driver for tape .... gt(7) 

gutil: graphical utilities. . . . gutil (IG) 

the DASI 450 terminal. 450: handle special functions of ... . 450(1) 

varargs: handle variable argument list . . . varargs(5) 

package, curses: CRT screen handling and optimization curses (3X) 

nohup: run a command immune to hangups and quits nohup(l) 

hsearch: manage hash search tables hsearch(3C) 

file, scnhdr : section header for a common object .... scnhdr(4) 

files, filehdr: file header for common object fielhdr(4) 
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Idahread: read the archive header ldahread(3X) 

file. Idfhread: read the file header of a common object ldfhread(3X) 

seek to the optional file header of a file. Idohseek: .... ldohseek(3X) 

read an indexed/named section header of a file. Idshread: .... ldshread(3X) 

help: ask for help *help(l) 

help: ask for help. help(l) 

handle special functions of HP terminals, hp: hp{l) 

and filters, hpd: graphical device routines . . gdev(lG) 

tables, hsearch: manage hash search .... hsearch(3C) 

function, cosh: Fortran hyperbolic cosine intrinsic .... cosh(3F) 

sinh: hyperbolic functions sinh(3M) 

function, sinh: Fortran hyperbolic sine intrinsic sinh(3F) 

function, tanh: Fortran hyperbolic tangent intrinsic . . . tanh(3F) 

function, hypot: Euclidean distance . » . . . hypot(3M) 

iargc iargc(3F) 

disk accounting data by user ID. diskusg: generate diskusg(lM) 

and names. id: print user and group IDs . . . id(l) 

setpgrp: set process group ID setpgrp(2) 

issue: issue identification file issue(4) 

file or file/ fuser: identify processes using a .... fuser(lM) 

what: identify SCCS files what(l) 

id: print user and group IDs and names id(l) 

group, and parent process IDs. /get process, process .... getpid(2) 

getuid: get user IDs getuid(2) 

setgid: set user and group IDs. setuid, setuid(2) 

core: format of core image file core(4) 

crash: examine system images crash (IM) 

pnch: file format for card images pnch(4) 

argument, aimag: Fortran imaginary part of complex aimag(3F) 

nohup: run a command immune to hangups and quits. . . . nohup(l) 

fine: fast incremental backup finc(lM) 

of a/ Idtbindex: compute the index of a symbol table entry . . . Idtbindex (3X) 

Fortran substring index: return location of index (3F) 

a file. Idtbread: read an indexed symbol table entry of . . . ldtbread(3X) 

of a file. Idshread: read an indexed/named section header . . . Idshread (3X) 

object/ Idsseek: seek to an indexed/named section of an ... . ldsseek(3X) 

initialization. init: process control init(lM) 

inittab: script for the init process inittab(4) 

init: process control initialization init(lM) 

brc: system initialization shell scripts. . . brc(lM) 

information bdblk: print, initialize, update bad bdblk(lM) 

process, popen: initiate pipe to/from a popen(3S) 

process. inittab: script for the init . . . inittab (4) 

clri: clear i-node clri(lM) 

inode: format of an i-node. . . . inode(4) 

inode: format of an i-node inode (4) 

scanf: convert formatted input scanf(3S) 

push character back into input stream, ungetc: ungetc(3S) 

fread: binary input/output fread(3S) 

stdio: standard buffered input/output package stdio(3S) 

f error: stream status inquiries f error (3S) 

uustat: uucp status inquiry and job control uustat(lC) 

install: install commands install(lM) 

install: install commands install (IM) 

directories, cpset: install object files in binary . . cpset(lM) 

conversion, int: explicit Fortran type .... ftype(3F) 

abs: return integer absolute value abs(3C) 

a641: convert between long integer and base-64 ASCII/ .... a641(3C) 

sputl: access long integer data in a/ sputl(3X) 

anint: Fortran nearest integer functions. . round (3F) 
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function, aint; Fortran integer part intrinsic aint(3F) 

strtol: convert string to integer strtol(3C) 

13tol: convert between 3-byte integers and long integers. . . . 13tol(3C) 

3-byte integers and long integers, /convert between .... 13tol(3C) 

bcopy: interactive block copy bcopy(lM) 

system, mailx: interactive message processing . . mailx(l) 

acu: Automatic Call Unit (ACU) interface acu(7) 

err: error-logging interface err (7) 

plot: graphics interface plot(4) 

plot: graphics interface subroutines plot(3X) 

termio: general terminal interface termio{7) 

tty: controlling terminal interface tty(7) 

spline: interpolate smooth curve spline(lG) 

characters, asa: interpret ASA carriage control . . asa{l) 

sno: SNCBOL interpreter sno(l) 

pipe: create an interprocess channel pipe (2) 

facilities/ ipcs: report inter-process communication .... ipcs(l) 

package, ftok: standard interprocess communication .... stdipc(3C) 

suspend execution for an interval, sleep: sleep(l) 

sleep: suspend execution for interval sleep(3C) 

acos: Fortran arccosine intrinsic function acos(3F) 

aint: Fortran integer part intrinsic function aint(3F) 

asin: Fortran arcsine intrinsic function asin(3F) 

atan2: Fortran arctangent intrinsic function atan2{3F) 

atan: Fortran arctangent intrinsic function atan(3F) 

Fortran complex conjugate intrinsic function, conjg: .... conjg{3F) 

cos: Fortran cosine intrinsic function cos(3F) 

Fortran hyperbolic cosine intrinsic function, cosh: cosh(3F) 

double precision product intrinsic function, drpod: .... dprod(3F) 

exp: Fortran exponential intrinsic function exp(3F) 

Fortran common logarithm intrinsic function. Iogl0: .... logl0(3F) 

log: Fortran natural logarithm intrinsic function log(3F) 

sign: Fortran transf er-of-sign intrinsic function sign(3F) 

sin: Fortran sine intrinsic function sin(3F) 

sinh: Fortran hyperbolic sine intrinsic function. ....... sinh(3F) 

sqrt: Fortran square root intrinsic function sqrt(3F) 

tan: Fortran tangent intrinsic function tan{3F) 

Fortran hyperbolic tangent intrinsic function, tanh: tanh(3F) 

dim: positive difference intrinsic functions dim(3F) 

mod: Fortran remaindering intrinsic functions mod(3F) 

Ige: string comparison intrinsic functions strcmp(3F) 

commands intro: introduction to intro(l) 

formats, intro: introduction to intro(4) 

maintenance commands intro: introduction to intro(lM) 

miscellany, intro: introduction to intro(5) 

files, intro: introduction to intro(7) 

subroutines and libraries, intro: introduction to intro(3) 

calls and error numbers, intro: introduction to system . . . intro(2) 

maintenance procedures, intro: introduction to system . . . intro(8) 

intro: introduction to commands intro(l) 

intro: introduction to file formats. . . intro(4) 

commands intro: introduction to maintenance .... intro (IM) 

intro: introduction to miscellany. . . . intro(5) 

intro: introduction to special files . . . intro(7) 

and libaries. intro: introduction to subroutines .... intro (3) 

and error numbers, intro: introduction to system calls . . . intro (2) 

maintenance/ intro: introduction to system intro (8) 

ncheck: generate names from i-numbers ncheck(lM) 

ioctl: control device ioctl(2) 

abort: generate an lOT fault abort(3C) 
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ipcrm: remove a message queue . . . ipcrm(l) 

communication facilities/ ipcs: report inter-process .... ipcs(l) 

generator. irand: random number rand(3F) 

isalpha: classify characters . . , ctype(3C) 

Fortran, system: issue a shell command from .... system(3F) 

system: issue a shell command system(3S) 

issue: issue identification file issue(4) 

file. issue: issue identification .... issue(4) 

news: print news items news(l) 

functions. j0, jl, jn, y0 , yl, yn: Bessel . . bessel(3M) 

functions. j0, jl, jn, y0 , yl, yn: Bessel .... bessel (3M) 

functions. j0, jl, jn, y0, yl, yn: Bessel bessel (3M) 

operator, join: relational database join(l) 

makekey: generate encryption key makekey(l) 

killall: kill all active processes killall{lM) 

process or a group of/ kill: send a signal to a kill(2) 

kill: terminate a process kill(l) 

processes, killall: kill all active killall(lM) 

integers and long integers. 13tol: convert between 3-byte . . . 13tol(3C) 

copy file systems with label checking, volcopy: volcopy(lM) 

scanning and processing language, awk: pattern awk(l) 

arbitrary-precision arithmetic language, be: bc(l) 

efl: Extended Fortran Language efl(l) 

cpp: the C language preprocessor cpp(l) 

command programming language, /standard/restricted . . sh(l) 

shl: shell layer manager shl(l) 

object files. Id: link editor for common .... ld(l) 

header Idahread: read the archive .... ldahread{3X) 

file. Idclose: close a common object . . ldclose(3X) 

access routines. Idfcn: common object file ldfcn(4) 

of a common object file. Idf bread: read the file header . . Idf bread (3X) 

name for file symbol table/ Idgetname: retrieve symbol .... Idgetname (3X) 

number entries of a file/ Idlread: manipulate line ldlread(3X) 

entries of a section of a/ Idlseek: seek to line number . . . ldlseek(3X) 

file header of a file Idohseek: seek to the optional . . ldohseek(3X) 

file for reading. Idopen: open a common object . . . ldopen(3X) 

entries of a section of a/ Idrseek: seek to relocation .... ldrseek(3X) 

indexed/named section header/ Idshread: read an ldshread(3X) 

indexed/named section of an/ Idsseek: seek to an ldsseek(3X) 

of a symbol table entry of a/ Idtbindex: compute the index . . . Idtbindex (3X) 

symbol table entry of a file. Idtbread: read an indexed ldtbread(3X) 

table of a common object/ Idtbseek: seek to the symbol . . . ldtbseek{3X) 

string, len: return length of Fortran . . . len(3F) 

len: return length of Fortran string. .... len(3F) 

getopt: get option letter from argument vector. . . . getopt(3C) 

simple lexical tasks. lex: generate programs for .... lex(l) 

generate programs for simple lexical tasks, lex: lex(l) 

intrinsic functions. Ige: string comparision strcmp(3F) 

to subroutines and libraries, /introduction intro(3) 

relation for an object library, /find ordering lorder(l) 

portable/ ar: archive and library maintainer for ar(l) 

ulimit: get and set user limits ulimit(2) 

an out-going-terminal line connection, /establish .... dial(3C) 

type, modes, speed, and line discipline, /set terminal . . getty(lM) 

line: read one line line(l) 

common object file, linenum: line number entries in a linenum(4) 

function. Idlread: manipulate line number entries of a file . . . Idlread (3X) 

section of a/ Idlseek: seek to line number enteries of a Idlseek (3X) 

file, strip: strip symbol and line number information from a . . strip(l) 

nl: line numbering filter nl(l) 
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out selected fields of each line of a file, cut: cut cut(l) 

send/cancel requests to an LP line printer. Ip, cancel: lp(l) 

Ip: line printer lp(7) 

line: read one line line(l) 

Isearch: linear search and update lsearch(3C) 

col: filter reverse line-feeds col(l) 

in a common object file, linenum: line number entries . . . linenum(4) 

files, comm: select or reject lines common to two sorted .... coram(l) 

uniq: report repeated lines in a file uniq(l) 

paste: merge same lines of several file paste(l) 

link: exercise link and unlink system calls . . . link{lM) 

files. Id: link editor for common object . . . ld(l) 

a. out: common assembler and link editor output a. out (4) 

system calls, link: exercise link and unlink . . link(lM) 

link: link to a file link (2) 

cp. In, mv: copy, link or move files cp(l) 

link: link to a file link (2) 

lint: a C program checker lint(l) 

Is: list contents of directory. . . . ls(l) 

for a file system, ff: list file names and statistics . . ff(lM) 

nlist: get entries from name list nlist(3C) 

nm: print name list of common object file. . . . nm(l) 

by fsck. checklist: list of file systems processed . . checklist{4) 

handle variable argument list, varargs: varargs(5) 

output of a varargs argument list, /print formatted vprintf(3S) 

output of a varargs argument list, /print formatted vprintf (3X) 

xargs: construct argument list(s) and execute command. . . . xargs(l) 

files, cp, In, mv: copy, link or move .... cp(l) 

indexi return location of Fortran substring. . . index (3F) 

end: last locations in program end(3C) 

memory, plock: lock process, text, or data in . . plock(2) 

intrinsic function, log: Fortran natural logarithm . . log(3F) 

gamma: log gamma function gamma (3M) 

newgrp: log in to a new group newgrp{l) 

logarithm intrinsic function. Iogl0: Fortran common logl0(3F) 

logl0: Fortran common logarithm intrinsic function. . . logl0(3F) 

log: Fortran natural logarithm intrinsic function. . . log(3F) 

functions, exp: exponential, logarithm, power, square root . . . exp(3M) 

errpt: process a report of logged errors errpt(lM) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

cuserid: get character login name of the user cuserid(3S) 

logname: return login name of user logname (3X) 

passwd: change login password passwd(l) 

login: sign on login(l) 

setting up an environment at login time, profile: profile (4) 

logname: get login name logname (1) 

user, logname: return login name of . . . logname (3X) 

string. a641: convert between long integer and base-64 ASCII . . a641(3X) 

sputl: access long integer data in a/ sputl(3X) 

between 3-byte integers and long integers. 13tol: convert . . . 13tol(3C) 

for an object library, lorder: find ordering relation . . lorder{l) 

nice: run a command at low priority nice(l) 

requests to an LP line/ Ip, cancel: send/cancel lp(l) 

send/cancel requests to an LP line printer. Ip, cancel: . . . lp(l) 

Ip: line printer lp(7) 

enable: enable/disable LP printers enable (1) 

Ipsched: start/stop the LP request scheduler Ipsched(lM) 

accept: allow/prevent LP requests accept (IM) 

Ipadmin: configure the LP spooling system Ipadmin(lM) 
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Ipstat: print LP status information Ipstat(l) 

spooling system. Ipadmin: configure the LP Ipadmin(lM) 

request scheduler Ipsched: start/stop the LP .... lpsched{lM) 

information. Ipstat: print LP status Ipstat(l) 

directory. Is: list contents of ....... ls(l) 

update. Isearch: linear search and .... lsearch(3C) 

pointer. Iseek: move read/write file .... lseek(2) 

m4: macro processor m4(l) 

values: machine-dependent values values (5) 

/access long integer data in a machine-independent fashion .... sputl(3X) 

m4: macro processor m4(l) 

send mail to user or read mail, mail: mail(l) 

read mail, mail: send mail to users or ... . mail(l) 

mail: send mail to users or read mail. . . . mail(l) 

processing system, mailx: interactive message .... mailx(l) 

malloc: main memory allocator malloc(3C) 

malloc: fast main memory allocator malloc (3X) 

regenerate groups of/ make: maintain, update, and make(l) 

ar: archive and library maintainer for portable/ ar{l) 

intro: introduction to maintenance commands intro(lM) 

intro: introduction to system maintenance procedures intro(8) 

sees file, delta: make a delta (change) to an ... . delta (1) 

mkdir: malce a directory mkdir(l) 

or ordinary file, mknod: make a directory, or a special . . mknod(2) 

mktemp: make a unique file name mktemp(3C) 

regenerate groups of/ make: maintain, update, and .... make(l) 

banner: make posters banner (1) 

key. makekey: generate encryption . . . makekey(l) 

allocator, malloc: fast main memory malloc(3X) 

malloc: main memory allocator. . . malloc (3C) 

manual, man: print entries in this .... man(l) 

tsearch: manage binary search trees. . . . tsearch(3C) 

hsearch: manage hash search tables hsearch(3C) 

shl: shell layer manager shl(l) 

records, fwtmp: manipulate connect accounting . . . fwtmp(lM) 

of a file function. Idlread: manipulate line number entries . . ldlread(3X) 

floating-point/ frexp manipulate parts of frexp(3C) 

man: print entries in this manual man(l) 

ascii: map of ASCII character set. . . . ascii(5) 

files, diffmk: mark differences between diffmk(l) 

umask: set file-creation mode mask umask(l) 

set and get file creation mask, umask: umask (2) 

table, master: master device information .... master (4) 

information table, master: master device ....... master (4) 

regular expression compile and match routines, regexp: regexp(5) 

math: math functions and constants. . . math (5) 

constants, math: math functions and math (5) 

function, matherr: error-handling ...... matherr(3M) 

multiple-access-user-space/ maus: maus(2) 

functions, max: Fortran maximum-value .... raax{3F) 

max: Fortran maximum-value functions max(3F) 

accounting, mclock: return Fortran time .... mclock(3F) 

mem: core memory mem(7) 

memccpy: memory operations. . . . memory (3C) 

malloc: main memory allocator malloc(3C) 

malloc: fast main memory allocator malloc (3X) 

shmctl: shared memory control operatidns shmctl(2) 

mem: core memory mem(7) 

/(shared memory) operations maus (2) 

memccpy: memory operations memory (3C) 
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shmop: shared 




. shmop(2) 


lock process, text, or data in 




. plock(2) 


shroget: get shared 




. shmget(2) 


sort: sort and/or 




. sort(l) 


files, acctmerg: 


merge or add total accounting . . 


. acctmerg (IM) 


file paste: 


merge same lines of severed ... 


. paste(l) 




mesg: permit or dei^ messages. 


. mesg ( 1 ) 


msgctl : 


message control oeprations. . . 


. msgctl (2) 


msgop: 




. msgop(2) 


mailx: interactive 




. mailx(l) 


ipcrm: remove a 




. ipcrm(l) 


msgget: get 




. msgget (2) 


mesg: permit or deny 




. mesg(l) 


perror: system error 




. perror (3C) 


functions. 


min: Fortran minimum-value . . . 


. min{3F) 


min: Fortran 




. min(3F) 






. mkdir(l) 




mkfs: construct a file system. 


. mkfs(lM) 






. mknod (IH) 


special or ordinary file. 


mknod: make a directory, or a . . 


. mknod (2) 


name. 


mktemp: make a unique file ... 


. mktemp (3C) 


table . 


mnttab: mounted file system ... 


. mnttab (4) 


intrinsic functions. 




. mod(3F) 


chmod: change 




. chmod ( 1 ) 


umask: set file-creation 




. umask ( 1 ) 


chmod: change 




. chmod ( 2 ) 


getty: set terminal type. 




. getty (IM) 


bs: a compiler/interpreter for 




. bs(l) 


touch: update access and 


modification times of a file. 


. touch (1) 


utime: set file access and 




. utime(2) 


profile. 


monitor: prepare execution . . . 


. monitor (3C) 


uusub: 




. uusub (IM) 


mount: 


mount a file system 


. mount (2) 


system, mount: 




. mount (IH) 




mount: mount a file system. . . 


. mount(2) 


system. 


mount: mount and dismount file 


. mount (IM) 


setmnt: establish 




. setmnt (IM) 


mnttab : 




. mnttab (4) 


mvdir : 




. mvdir (IM) 


cp. In, mv: copy, link or 




. cp(l) 


Iseek : 


move read/write file pointer. 


. Iseek (2) 


gd: general driver for 




• gd(7) 


operations. 




. msgctl (2) 






. msgget(2) 


(shared memory)/ maus: 


msgop: message operations. . . 


. msgop(2) 


multiple- access-user-space . . . 


. maus (2) 


cp. In, 


mv: cop;^, link or move files. 


. cp(l) 






. mvdir (IM) 


function, log: Fortran 


natural logarithm intrinsic . . . 


. log(3F) 


i-numbers. 


ncheck: generate names from . . . 


. ncheck (IN) 


anint: Fortran 




. round (3F) 


analysis, serverdaemon: 


network debugging and error . . . 


. serverdaemon(l) 


netstat: display 




. netstat (1) 


commands, stat: statistical 


network useful with graphical . . 


. stat(lG) 


uusub: monitor uucp 




. uusub(lM) 


a text file. 


newform: change the format of . . 


. newform(l) 




newgrp: log in to a new group. 


. newgrp(l) 


news: print 




. news(l) 






. news(l} 


process. 


nice: change priority of a ... 


. nice (2) 
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priority, nice: run a command at low .... nice(l) 

nl: line numbering filter nl(l) 

list, nlist: get entries from name . . . nlist(3C) 

object file, nm; print name list of common . . . nm(l) 

hangups and quits, nohup: run a command immune to . . nohup(l) 

setjmp: non-local goto setjmp(3C) 

null: the null file null(7) 

null: the null file null(7) 

nl: line numbering filter nl(l) 

graphics: access graphical and numerical commands graphics (IG) 

idfcn: common object file access routines. . . . idfcn(4) 

dump selected parts of an object file, dump: dump(l) 

Idopen: open a common object file for reading ldopen(3X) 

Idclose: close a common object file ldclose(3X) 

the file header of a common object file. Idfhread: read .... ldfhread(3X) 

indexed/named section of an object file, /seek to an ldsseek{3X) 

the symbol table of a common object file, /seek to ldtbseek(3X) 

number entries in a common object file, linenum: line .... linenum{4) 

nm: print name list of common object file nm(l) 

information for a common object file, /relocation reloc(4) 

section header for a common object file, scnhdr: scnhdr(4) 

format, syms: common object file symbol table syms(4) 

file header for common object files, filehdr: filehdr(4) 

directories, cpset: install object files in binary cpset(lM) 

Id: link editor for common object files ld{l) 

print section sizes of common object files, size: . size(l) 

find ordering relation for an object library, lorder: lorder(l) 

od: octal dump od(l) 

od: octal dump od(l) 

reading. Idopen: open a common object file for . . . ldopen(3X) 

fopen: open a stream fopen(3S) 

dup: duplicate an open file descriptor dup(2) 

open: open for reading or writing. . . . open(2) 

writing, open: open for reading or open(2) 

prfld: operating system profiler. .... profiler (IM) 

/(shared memory) operations maus(2) 

memccpy: memory operations memory {3C) 

msgctl: message control operations msgctl(2) 

msgop: message operations msgop(2) 

semctl: semaphore control operations semctl(2) 

semop: semaphore operations semop(2) 

shmctl : shared memory control operations shmctl(2) 

shmop: shared memory operations shmop(2) 

strcat: string operations string (3C) 

join: relational database operator join(l) 

dcopy: copy file systems for optimal access time dcopy(lM) 

CRT screen handling and optimization package, curses: . . curses (3X) 

vector, getopt: get option letter from argument .... getopt(3C) 

file. Idohseek: seek to the optional file header of a ldohseek(3X) 

fcntl: file control options fcntl(5) 

stty: set the options for a terminal stty(l) 

getopt: parse command options getopt (1) 

functions, and, or, xor, not: Fortran boolean . . . bool(3F) 

object library, lorder: find ordering relation for an lorder (1) 

a directory, or a special or ordinary file, mknod: make .... mknod(2) 

dial: establish an out-going terminal line/ dial(3C) 

assembler and link editor output, a. out: common a. out (4) 

vprintf: print formatted output of a varargs argument/ . . . vprintf(3S) 

vprintf: print formatted output of a varargs argument/ . . . vprintf (3X) 

printf: print formatted output printf(3S) 
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acc disk: overview of accounting acct(lM) 

chown: change owner and group of a file chown(2) 

chown: change owner or group chown (1) 

files, pack: compress and expand pack(l) 

handling and optimization package, curses: CRT screen .... curses (3X) 

sal: system activity report package sar(lM) 

standard buffered input/output package, stdio: stdio(3S) 

interprocess communication package, ftok: standard stdipc(3C) 

4014 terminal. 4014: paginator for the TEKTRONIX .... 4014(1) 

process, process group, and parent process IDs. /get getpid(2) 

getopt: parse command options getopt(l) 

passwd: change login password. . . passwd(l) 

passwd: password file passwd(4) 

getpwent: get password file entry getpwent(3C) 

putpwent: write password file entry putpwent(3C) 

passwd: password file passwd(4) 

getpass: read a password getpass(3C) 

passwd: change login password passwd(l) 

pwck: password/group file checker. . . . pwck(lM) 

several file paste: merge same lines of .... paste(l) 

dirname: deliver portions of path names, basename, basename(l) 

directory, getcwd: get path-name of current working . . . getcwd(3C) 

grep: search a file for a pattern grep(l) 

processing language, awk : pattern scanning and awk(l) 

signal, pause: suspend process until . . . pause(2) 

mesg: permit or deny messages mesg(l) 

format, acct: per-process accounting file .... acct(4) 

acctcms: command summary from per-process accounting/ acctcms(lM) 

perror: system error messages. . . perror(3C) 

terminals, pg: file perusal filter for soft-copy . . . pg(l) 

soft-copy terminals, pg: file perusal filter for .... pg(l) 

split: split a file into pieces split (1) 

channel, pipe: create an interprocess . . . pipe (2) 

tee: pipe fitting tee(l) 

popen: initiate pipe to/from a process popen(3S) 

data in memory, plock: lock process, text, or . . . plock(2) 

plot: graphics interface plot (4) 

subroutines plot: graphics interface plot(3X) 

images, pnch: file format for card .... pnch(4) 

fseek: reposition a file pointer in a stream fseek(3S) 

Iseek: move read/write file pointer lseek(2) 

process, popen: initiate pipe to/from a . . popen(3S) 

and library maintainer for portable archives, /archive . . . . ar(l) 

basename, dirname: deliver portions of path names basename(2) 

functions, dim: positive difference intrinsic . . . dim(3F) 

banner: make posters banner (1) 

exp: exponential, logarithm, power, square root functions. . . exp(3M) 

pr: print files pr(l) 

functions, dprod: double precision product intrinsic .... dprod(3F) 

monitor: prepare execution profile monitor (3C) 

cpp: the C language processor cpp(l) 

unget: undo a previous get of an SCCS file. . . unget(l) 

profiler, prf: operating system prf(7) 

profiler, prfld: operating system profiler(lM) 

graphical/ gps: graphical primitive string, format of ... . gps(4) 

types: primitive system data types. . . . types (5) 

prs: print an SCCs file prs(l) 

date: print and set the date date(l) 

cal: print calendar cal(l) 

of a file, sum: print checksum and block count . . sum(l) 
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editing activity, sact: print current SCCS file sact(l) 

man: print entries in this manual. . . man(l) 

cat: concatenate and print files cat(l) 

pr: print files pr(l) 

varargs argument/ vprintf: print formatted output of a ... . vprintf(3S) 

varargs argument/ vprintf: print formatted output of a ... . vprintf {3X) 

printf: print formatted output printf(3S) 

information bdblk: print, initialize, update bad . . . bdblk(lM) 

Ipstat: print LP status information. . . . Ipstat(l) 

object file, nm: print name list of common nm(l) 

system, uname: print name of current UNIX .... uname{l) 

news: print news items. news(l) 

file{s). acctcom: search and print process accounting acctcom(l) 

object files, size: print section sizes of common . . . size(l) 

names, id: print user and group IDs and . . . id(l) 

requests to an LP line printer, /cancel: send/cancel . . . lp(l) 

Ip: line printer lp(7) 

enable: enable/disable LP printers enable (1) 

output, printf: print formatted printf (3S) 

nice: run a command at low priority nice(l) 

nice: change priority of a process nice{2) 

errors, errpt: process a report of logged .... errpt(lM) 

acct: enable or disable process accounting acct(2) 

acctprcl: process accounting acctprc(lM) 

acctcom: search and print process accounting file(s). . . . acctcomd) 

alarm: set a process alarm clock alarm(2) 

times, times: get process and child process times(2) 

initialization, init: process control init(lM) 

timex: time a command; report process data and system/ timex(l) 

exit: terminate process exit(2) 

fork: create a new process fork (2) 

process/ getpid: get process process group, and parent getpid(2) 

setpgrp: set process group ID setpgrp(2) 

process group, and parent process IDs. /get process, .... getpid(2) 

inittab: script for the init process inittab(4) 

kill: terminate a process kill(l) 

nice: change priority or a process nice (2) 

kill: send a signal to a process or a group of/ kill(2) 

popen: initiate pipe to/from a process popen(3S) 

parent process/ getpid: get process, . process group, and .... getpid(2) 

ps: report process status ps(l) 

memory, plock: lock process, text, or data in plock(2) 

times: get process and child process times times (2) 

wait: wait for child process to stop or terminate. . . wait(2) 

ptrace: process trace ptrace(2) 

pause: suspend process until signal. pause (2) 

wait: await completion of process wait(l) 

list of file systems processed by fsck. checklist: . . . checklist(4) 

to a process or a group of processes, /send a signal kill(2) 

killall: kill all active processes killall(lM) 

structure, fuser: identify processes using a file or file . . fuser(lM) 

awk: pattern scanning and processing language awk(l) 

shutdown: terminate all processing shutdown (IM) 

mailx: interactive message processing system mailx(l) 

m4: macro processor m4(l) 

provide truth value about processor type machid(l) 

dprod: double precision product intrinsic function. . . . dprod(3F) 

prof: display profile data. . . . prof(l) 

function, prof: profile within a prof (5) 

profile, profil: execution time profil(2) 
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prof: display profile data prof(l) 

monitor: prepare execution profile monitor (3C) 

profil: execution time profile profil(2) 

environment at login time profile: setting up an profile (4) 

prof: profile within a function prof (5) 

prf: operating system profiler prf(7) 

prfld: operating system profiler profiler(lM) 

sadp: disk access profiler sadp(lM) 

standard/restricted command programming language, /the .... sh{l) 

processor type: provide truth value about machid(l) 

true: provide truth values true(l) 

prs: print an SCCS file prs(l) 

ps: report process status ps(l) 

sxt: pseudo-device driver sxt(7) 

'generate uniformly distributed pseudo-random numbers drand48(3C) 

ptrace: process trace ptrace(2) 

stream, ungetc: push character back into input . . ungetc(3S) 

a stream, putc: put character or word on . . putc(3S) 

environment, putenv: change or add value to . . putenv(3C) 

entry, putpwent: write password file . . . putpwent(3C) 

stream, puts: put a string on a puts(3S) 

checkers, pwck: password/group file pwck(lM) 

pwd; working directory name. . . . pwd(l) 

qsort: quicker sort qsort(3C) 

tput: query terminfo database tput(l) 

ipcrm: remove a message queue ipcrm(l) 

msgget: get message queue msgget(2) 

qsort: quicker sort qsort(3C) 

command immune to hangups and quits, nohup: run a nohup(l) 

generator, rand: simple random-number .... rand(3C) 

irand: random number generator rand(3F) 

rand: simple random-number generator rand(3C) 

f split: split f77, ratfor, or efl files fsplit(l) 

dialect, ratfor: rational Fortran ratfor (1) 

ratfor: rational Fortran dialect ratfor (1) 

getpass: read a password getpass(3C) 

entry of a file. Idtbread: read an indexed symbol table . . . ldtbread(3X) 

header of a file. Idshread: read an indexed/named section . . . ldshread(3X) 

read: read from file read(2) 

mail: send mail to users or read mail mail(l) 

line: read one line line(l) 

read: read from file read(2} 

Idahread: read the archive header ldahread(3X) 

common object file. Idfhread: read the file header of a ldfhread(3X) 

open a common object file for reading. Idopen: ldodpen(3X) 

open: open for reading or writing open(2) 

Iseek: move read/write file pointer lseek(2) 

specify what to do upon receipt of a signal, signal: . . . signal (2) 

/specify Fortran action on receipt of a system signal. . . . signal (3F) 

lockf: record and file locking lockf(2) 

from per-process accounting records, /command summary acctcms(lM) 

errdead: extract error records from dump errdead(lM) 

manipulate connect accounting records. fwtmp: fwtmp(lM) 

tape, free: recover files from a backup .... frec(lM) 

ed, red: text editor. ed(l) 

regular expression regcmp: compile and execute .... regcmp(3X) 

compile, regcmp: regular expressions .... regcmp(l) 

make: maintain, update, and regenerate groups of programs. . . make(l) 

compile and match routines, regexp: regular expression .... regexp(5) 

match routines, regexp: regular expression compile and . . regexp(5) 
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regcmp: regular expression compile. . . . regcmp(l) 

regcmp: compile and execute regular expression regcmp(3X) 

sorted files, comm: select or reject lines common to two .... coram(l) 

lorder: find ordering relation for an object/ lorder(l) 

join: relational database operator. . . join(l) 

for a common object file. reloc: relocation information . . . reloc(4) 

strip: remove symbols and relocation bits strip(l) 

section of a/ Idrseek: seek to relocation entries of a ldrseek{3X) 

common object file, reloc: relocation information for a ... reloc (4) 

floor: floor, ceiling, remainder, absolute value/ .... floor{3M) 

functions, mod: Fortran remaindering intrinsic mod(3F) 

calendar: reminder service calendar (1) 

netlet: execute command on remote system netlet(l) 

run: run command on a remote system run(l) 

ct: spawn getty to a remote terminal ct(lC) 

file, rmdel : remove a delta from an SCCS .... rmdel(l) 

ipcrm: remove a message gueue ipcrm(l) 

unlink: remove directory entry unlink (2) 

rm: remove files or directores. . . . rm(l) 

bits, strip: remove symbols and relocation . . . strip(l) 

uniq: report repeated lines in a file uniq(l) 

clock: report CPU time used clock (3C) 

communication/ ipcs: report inter-process ipcs(l) 

blocks, df: report number of free disk .... df(lM) 

errpt: process a report of logged errors errpt(lM) 

sal: system activity report package sar(lM) 

timex: time a command: report process data and system/ . . timex(l) 

ps: report process status ps(l) 

file, uniq: report repeated lines in a .... uniq(l) 

trenter: enter a trouble report trenter(l) 

sar: system activity reporter sar(l) 

stream, fseek: reposition a file pointer in a . . fseek(3S) 

Ipsched: start/stop the LP request scheduler Ipsched(lM) 

accept: allow/prevent LP requests accept (IM) 

Ip, cancel: send/cancel requests to an LP line/ lp(l) 

recover: restore files from tape to disk . . recover(l) 

symbol table/ Idgetname: retrieve symbol name for file . . . ldgetname{3X) 

argument, getarg: return Fortran command-line .... getarg{3F) 

variable, getenv: return Fortran environment .... getenv(3F) 

accounting, mclock: return Fortran time mclock(3F) 

abs: return integer absolute value. . . abs(3C) 

string, len: return length of Fortran len(3F) 

substring, index: return location of Fortran .... index (3F) 

logname: return login name of user logname(3X) 

name, getenv: return value for environment . . . getenv(3C) 

Stat: data returned by stat system call. . . stat(5) 

col: filter reverse line-feeds col(l) 

creat: create a new file or rewrite an existing one creat(2) 

directories. rm: remove files or rm(l) 

SCCS file rmdel: remove a delta from an . . . rmdel (1) 

chroot: change root directory chroot(2) 

chroot: change root directory for a command. . . chroot(lM) 

logarithm, power, square root functions, /exponential, . . . exp(3M) 

sgrt: Fortran square root intrinsic function sqrt(3F) 

hpd: graphical device routines and filters . gdev(lG) 

common object file access routines. Idfcn: ldfcn(4) 

expression compile and match routines, regexp: regular regexp(5) 

graphical table of contents routines, toe: toc(lG) 

nice: run a command at low priority. . . nice(l) 

hangups and quits, nohup: run a command immune to nohup(l) 
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run: run command on remote system. . . run(l) 

runacct: run daily accounting runacct(lM) 

runacct: run daily accounting. . . runacct (IM) 

package, sal: system activity report .... sar(lM) 

editing activity, sact: print current SCCS file . . . sact(l) 
sadp: disk access profiler. . . . sadp(lM) 
sag: system activity graph. . . . sag(lG) 
sar: system activity reporter. . . sar(l) 

input. scanf: convert formatted scanf(3S) 

Dfs: big file scanner bfs(l) 

language, awk: pattern scanning and processing swk(l) 

the delta commentary of an SCCS delta, cdc: change cdc(l) 

comb: combine SCCS deltas comb(l) 

make a delta (change) to an SCCS file, delta: delta(l) 

sact: print current SCCS file editing activity. . . . sact(l) 

get: get a version of an SCCS file get(l) 

prs: print an SCCS file prs(l) 

rmdel : remove a delta from an SCCS file rmdel (l) 

compare two versions of an SCCS file, sccsdiff: sccsdiff(l) 

sccsfile: format of SCCS file sccsfile(4) 

undo a previous get of an SCCS file, unget: unget(l) 

val: validate SCCS file val(l) 

admin: create and administer SCCS files admin (1) 

what: identify SCCS files what(l) 

of an SCCS file sccsdiff: compare two versions . . sccsdiff(l) 
sccsfile: format of SCCS file. . . sccsfile(4) 

start/stop the LP request scheduler Ipsched: Ipsched(lM) 

common object file, scnhdr: section header for a ... scnhdr(4) 

optimizatioin/ curses: CRT screen handling and curses(3X) 

vi: screen-oriented editor vi(l) 

inittab: script for the init process. . . . inittab(4) 

system initialization shell scripts, brc: brc(lM) 

sdb: symbolic debugger sdb(l) 

program, sdiff: side-by-side difference . . sdiff(l) 

grep: search a file for a pattern. . . . grep(l) 

bsearch: binary search a sorted table bsearch(3C) 

accounting file(s). acctcom: search and print process acctcom(l) 

Isearch: linear search and update lsearch(3C) 

hsearch: manage hash search tables hsearch(3C) 

tsearch: manage binary search trees tsearch(3C) 

object file, scnhdr: section header for a common .... scnhdr (4) 

/read an indexed/named section header of a file ldshread(3X) 

to line number entries of a section of a file, /seek ldlseek(3X) 

to relocation entries of a section of a file, /seek ldrseek(3X) 

/seek to an indexed/named section of an object file ldsseek(3X) 

files, size: print section sizes of common object . . size(l) 

sed: stream editor sed(l) 

section of an object/ Idsseek: seek to an indexed/named ldsseek(3X) 

a section of a file. Islseek: seek to line number entries of . . ldlseek(3X) 

a section of a file. Idrseek: seek to relocation entries of . . . ldrseek(3X) 

header of a file. Idohseek: seek to the optional file ldohseek(3X) 

common object file. Idtbseek: seek to the symbol table of a . . . ldtbseek{3X) 

shmget: get shared memory segment shmget{2) 

brk: change data segment space allocation brk(2) 

to two sorted files, comm: select or reject lines common . . comm(l) 

greek: select terminal filter greek (1) 

of a file, cut: cut out selected fields of each line . . . cut(l) 

file, dump: dump selected parts of an object .... dump(l) 

semctl: semaphore control operations. . . semctl(2) 

semop: semaphore operations semop(2) 
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semget: get set of semaphores semget(2) 

operations, semctl : semaphore control semctl(2) 

semget: get set of semaphores semget (2) 

semop: semaphore operations. . . . semop(2) 

a group of processes, kill: send a signal to a process or . . . kill(2) 

mail, mail: send mail to users or read .... mail(l) 

line printer. Ip, cancel: send/cancel requests to an LP . . . lp(l) 

stream, setbuf: assign buffering to a . . . setbuf(3S) 

IDs. setuid, setgid: set user and group .... setuid(2) 

setjmp: non-local goto setjmp(3C) 

setmnt: establish mount table. . . setmnt(lM) 

setpgrp: set process group ID. . . setpgrp(2) 

login time, profile: setting up an environment at ... profile(4) 

gettydef: speed and terminal settings used by getty gettydefs(4) 

group IDs. setuid, setgid: set user and . . . setuid{2) 

standard/restricted command/ sh: shell, the sh(l) 

operations, shmctl: shared memory control shmctl(2) 

/multiple-access-user-space (shared memory) operations. . . . maus(2) 

shmop: shared memory operations shmsop(2) 

shmget: get shared memory segment shmget(2) 

system: issue a shell command from Fortran. . . . system{3F) 

system: issue a shell command system{3S) 

shl: shell layer manager shl(l) 

accounting, chargefee: shell procedures for acctsh(lM) 

addhd: shell script for add-on disk drive addhd{lM) 

brc: system initialization shell scripts brc(lM) 

command programming/ sh: shell, the standard/restricted . . sh(l) 

shl: shell layer manager. .... shl(l) 

operations, shmctl: shared memory control . . . shmctl (2) 

segment, shmget: get shared memory shmget (2) 

operations, shmop: shared memory shmop(2) 

processing, shutdown: terminate all shutdown(lM) 

program, sdiff: side-by-side difference sdiff(l) 

intrinsic function, sign: Fortran tr ansf er-of-sign . . sign(3F) 

login: sign on login (1) 

pause: suspend process until signal pause(2) 

what to do upon receipt of a signal, signal: specify signal (2) 

action on receipt of a system signal, /specify Fortran signal(3F) 

on receipt of a system/ signal: specify Fortran action . . signal {3F) 

upon receipt of a signal. signal: specify what to do .... signal (2) 

of processes, kill: send a signal to a process or a group . . kill(2) 

ssignal: software signals ssignal{3C) 

lex: generate programs for simple lexical tasks lex(l) 

generator, rand: simple random-number rand(3C) 

function, sin: Fortran sine intrinsic .... sin(3F) 

sin: trigonometric functions. . . trig(3M) 

sin: Fortran sine intrinsic function sin(3F) 

sinh: Fortran hyperbolic sine intrinsic function sinh(3F) 

intrinsic function, sinh: Fortran hyperbolic sine . . . sinh(3F) 

sinh: hyperbolic functions. . . . sinh{3M) 

common object files, size: print section sizes of ... size{l) 

size: print section sizes of common object files. . . size(l) 

an interval, sleep: suspend execution for . . . sleep(l) 

interval, sleep: suspend execution for . . . sleep(3C) 

current/ ttyslot: find the slot in the utmp file of the . . . ttyslot(3C) 

spline: interpolate smooth curve spline (IG) 

sno: SNOBOL interpreter sno(l) 

sno: SNCBOL interpreter sno{l) 

pg: file perusal filter for soft-copy terminals pg(l) 

ssignal: software signals ssignal(3C) 
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sort: sort and/or merge files sort(l) 

qsort: quicker sort qsort(3C) 

sort: sort and/or merge files. . . sort(l) 

tsort: topological sort tsort(l) 

or reject lines common to two sorted files, coram: select .... comm(l) 

bsearch: binary search a sorted table bsearch(3C) 

brk: change data segment space allocation brk(2) 

terminal, ct: spawn getty to a remote ct{lC) 

fspec: format specification in text files. . . . fspec{4) 

receipt of a system/ signal: specify Fortran action on signal (3F) 

receipt of a signal, signal: specify what to do upon signal (2) 

/set terminal type, modes, speed, and line discipline. . . . getty (IM) 

used by getty. gettydefs: speed and terminal settings . . . gettydefs(4) 

spell: find spelling errors. . . . spell(l) 

spell: find spelling errors spell(l) 

curve, spline: interpolate smooth .... spline(lG) 

split: split a file into pieces split (1) 

csplit: context split csplit(l) 

files, fsplit: split f77, ratfor, or efl fsplit(l) 

pieces, split: split a file into split{l) 

uuclean: uucp spool directory clean-up uuclean(lM) 

Ipadmin: configure the LP spooling system Ipadmin(lM) 

data in a machine-independent/ sputl: access long integer .... sputl(3X) 

intrinsic function, sqrt: Fortran square root sqrt(3F) 

exponential, logarithm, power, square root functions, exp: .... exp(3M) 

function, sqrt: Fortran square root intrinsic sqrt{3F) 

ssignal: software signals ssignal(3C) 

package, stdio: standard buffered input/output . . stdio(3S) 

communication package, ftok: standard interprocess stdipc(3C) 

programming/ sh: shell, the standard/restricted command .... sh(l) 

scheduler Ipsched: start/stop the LP request Ipsched(lM) 

startnet: starts WorkNet startnet(lM) 

system call. stat: data returned by stat .... stat{5) 

Stat: get file status stat(2) 

useful with graphical/ stat: statistical network stat{lG) 

stat: data returned by stat system call stat (5) 

with graphical/ stat: statistical network useful .... stat(lG) 

ff: list file names and statistics for a file system. . . ff(lM) 

ustat: get file system statistics ustat{2) 

Ipstat: print LP status information lpstat{l) 

f error: stream status inquiries. ferror{3S) 

control, uustat: uucp status inquiry and job uustat{lC) 

communication facilities status, /report inter-process . . . ipcs{l) 

ps: report process status ps(l) 

stat: get file status stat(2) 

input/output package, stdio: standard buffered stdio (3S) 

stime: set time stime(2) 

wait for child process to stop or terminate, wait: wait (2) 

stopnet: stops WorkNet gracefully stopnet(lM) 

strcat: string operations string (3C) 

sed: stream editor sed(l) 

fclose: close or flush a stream fclose(3S) 

fopen: open a stream fopen(3S) 

reposition a file pointer in a stream, fseek: fseek(3S) 

get character or word from a stream, getc: getc(3S) 

gets: get a string from a stream gets(3S) 

put character or word on a stream, putc: putc(3S) 

puts: put a string on a stream puts(3S) 

setbuf: assign buffering to a stream setbuf(3S) 

ferror: stream status inquiries ferror{3S) 
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push character back into input stream, ungetc: ungetc(3S) 

long integer and base-64 ASCII string. a641: convert between . . . a641(3C) 

functions. Ige: string comparision intrinsic . . . strcmp(3F) 

convert date and time to string, ctime: ctime(3C) 

floating-point number to string, ecvt: convert ....... ecvt(3C) 

gps: graphical primitive string, format of graphical/ . . . gps(4) 

gets: get a string from a stream gets(3S) 

len: return length of Fortran string len(3F) 

puts: put a string on a stream puts(3S) 

strcat: string operations string (3C) 

number, strtod: convert string to double-precision .... strtod(3C) 

strtol: convert string to integer strtol(3C) 

relocation bits, strip: remove symbols and strip(l) 

number information from a/ strip: strip symbol and line . . . strip(l) 

information from a/ strip: strip symbol and line number . . . strip{l) 

double-precision number, strtod: convert string to strtod(3C) 

integer, strtol: convert string to strtol (3C) 

processes using a file or file structure, fuser: identify .... fuser(lM) 

terminal, stty: set the options for a . . . , stty(l) 

another user, su: become super-user or su(l) 

intro: introduction to subroutines and libraries intro{3) 

plot: graphics interface subroutines plot(3X) 

return location of Fortran substring, index: index (3F) 

count of a file, sum: print checksum and block . . . sum{l) 

accounting/ acctcms: command summary from per-process acctcms(lM) 

sync: update the super block sync{l) 

sync: update super-block sync (2) 

su: become super-user or another user. . . . su(l) 

interval, sleep: suspend execution for an sleep(l) 

interval, sleep: suspend execution for sleep(3C) 

pause: suspend process until signal. . . pause (2) 

swab: swap bytes swab(3C) 

swab: swap bytes swab(3C) 

sxt: pseudo-device driver sxt(7) 

information from/ strip: strip symbol and line number strip(l) 

table/ Idgetname: retrieve symbol name for file symbol .... ldgetname(3X) 

/retrieve symbol name for file symbol table entry ldgetname(3X) 

/compute the index of a symbol table entry of a file. . . Idtbindex (3X) 

Idtbread: read an indexed symbol table entry of a file. . . ldtbread(3X) 

syms: common object file symbol table format syms(4) 

object/ Idtbseek: seek to the symbol table of a common ldtbseek(3X) 

sdb: symbolic debugger sdb(l) 

In: create a symbolic link ln(l) 

strip: remove symbols and relocation bits. . . . strip(l) 

symbol table format, syms: common object file syms (4) 

sync: update super-block sync (2) 

sync: update the super block. . . sync(l) 

sysdef: system definition sysdef(lM) 

binary search a sorted table, bsearch: bsearch(3C) 

symbol name for file symbol table entry, /retrieve ldgetname(3X) 

/compute the index of a symbol table entry of a file Idtbindex (3X) 

/read an indexed symbol table entry of a file Idtbread (3X) 

common object file symbol table format, syms: syms (4) 

master device information table, master: master (4) 

mnttab: mounted file system table mnttab(4) 

Idtbseek: seek to the symbol table of a common object file. . . Idtbseek (3X) 

toe: graphical table of contents routines. . . . toc(lG) 

setmnt: establish mount table setmnt(lM) 

hsearch: manage hash search tables hsearch{3C) 

tabs: set tabs on a terminal tabs(l) 
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tabs: set tabs on a terminal . . . tabs(l) 

a file, tail: deliver the last part of . . tail(l) 

function, tan: Fortran tangent intrinsic . . tan(3F) 

tan: Fortran tangent intrinsic function. ... tan(3F) 

tanh: Fortran hyperbolic tangent intrinsic function. . . . tanh(3F) 

tangent intrinsic function, tanh: Fortran hyperbolic tanh(3F) 

gt: general driver for tape drives • gt(7) 

archive: tape file archiver archive(l) 

tar: tape file archiver tar(l) 

recover: tape file restorer recover (1) 

recover files from a backup tape, free: frec(lM) 

tar: tape file archiver tar(l) 

programs for simple lexical tasks, lex: generate lex(l) 

tee: pipe fitting tee(l) 

4014: paginator for the TEKTRONIX 4014 terminal 4014(1) 

tmpfile: create a temporary file tmpfile(3S) 

tmpnam: create a name for a temporary file tmpnam(3S) 

terminals, term: conventional names for . . . term(5) 

term: format of compiled term file term(4) 

file.. term: format of compiled term . . . term(4) 

for the TEKTRONIX 4014 terminal. 4014: paginator 4014(1) 

functions of the DASI 450 terminal. 450: handle special . . . 450(1) 

terminfo: terminal capability data base. . . terminfo(4) 

ct: spawn getty to a remote terminal ct(lC) 

generate file name for terminal, ctermid: ctermid(3S) 

greek: select terminal filter greek (1) 

termio: general terminal interface termio(7) 

tty: controlling terminal interface tty(7) 

dial: establish an out-going terminal line connection dial(3C) 

getty. gettydefs: speed and terminal settings used by gettydefs(4) 

stty: set the options for a terminal stty(l) 

tabs: set tabs on a terminal tabs(l) 

tty: get the name of the terminal tty{l) 

ttyname: find name of a terminal ttynarae(3C) 

and line/ getty: set terminal type, modes, speed, . . . getty (IM) 

300: DASI 300 and 300s terminals 300(1) 

handle special functions of HP terminals, hp: hp(l) 

perusal filter for soft-copy terminals, pg: file pg(l) 

term: conventional names for terminals term(5) 

kill: terminate a process kill(l) 

shutdown: terminate all processing shutdown(lM) 

abort: terminate Fortran program abort (3F) 

exit: terminate process exit (2) 

daemon, errstop: terminate the error-logging .... errstop(lM) 

for child process to stop or terminate, wait: wait wait (2) 

tic: terminfo compiler tic(lM) 

tput: query terminfo database tput(l) 

data base, terminfo: terminal capability . . . terminfo (4) 

interface, termio: general terminal termio (7) 

command, test: condition evaluation .... test(l) 

ed, red: text editor ed(l) 

edit: text editor edit(l) 

ex: text editor ex(l) 

change the format of a text file, newform: newform(l) 

fspec: format specification in text files f spec (4) 

plock: lock process, text, or data in memory plock(2) 

tic: terminfo compiler tic(lM) 

date and system/ timex: time a command; report process . . timex(l) 

time: time a command time(l) 

mclock: return Fortran time accounting mclock(3F) 
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execute commands at a later time, at: at(l) 

systems for optimal access time, dcopy: file dcopy(lM) 

time: get time time(2) 

profil: execution time profile profil(2) 

up an environment at login time, profile: setting prof ile(4) 

stime: set time stime{2) 

time: time a command time(l) 

time: get time time(2) 

ctime: convert date and time to string ctime(3C) 

clock: report CPU time used. clock (3C) 

process times, times: get process and child . . . times (2) 

update access and modification times of a file, touch: touch (1) 

get process and child process times, times: times(2) 

file access and modification times, utime; set . utime(2) 

process data and system/ timex: time a command; report . . . timex(l) 

file, tmpfile: create a temporary .... tmpfile(3S) 

temporary file, tmpnam: create a name for a . . . . tmpnam(3S) 

contents routines, toe: graphical table of toc{lG) 

popen: initiate pipe to/from a process popen(3S) 

tsort: topological sort tstor(l) 

acctmerg: merge or add total accounting files acctmerg(lM) 

modification times of a file, touch: update access and touch (1) 

toupper: translate characters. . . conv(3C) 

tplot: graphics filters tplot(lG) 

tput: query terminfo database. . . tput{l) 

tr: translate characters tr(l) 

trace: event-tracing driver. . . . trace{7) 

ptrace: process trace ptrace(2) 

function, sign: Fortran transf er-of-sign intrinsic .... sign(3F) 

toupper: translate characters conv{3C) 

tr: translate characters tr(l) 

ftw: walk a file tree. ftw(3C) 

tsearch: manage binary search trees tsearch(3C) 

report, trenter: enter a trouble trenter(l) 

sin: trigonometric functions trig(3M) 

trenter: enter a trouble report trenter (1) 

true: provide truth values. . . . true(l) 

type, provide truth value about processor .... machid(l) 

true: provide truth valUes true(l) 

trees, tsearch: manage binary search . . . tsearch(3C) 

tsort: topological sort tsort(l) 

interface, tty: controlling terminal tty(7) 

terminal, tty: get the name of the tty(l) 

terminal, ttyname: find name of a ttyname(3C) 

utmp file of the current/ ttyslot: find the slot in the . . . ttyslot(3C) 

int: explicit Fortran type conversion ftype(3F) 

file: determine file type file(l) 

truth value about processor type, provide machid{l) 

getty: set terminal type, modes, speed, and line/ . . . getty(lM) 

types, types: primitive system data . . . types (5) 

types: primitive system data types types (5) 

getpw: get name from UID getpw(3C) 

limits, ulimit: get and set user ulimit(2) 

creation mask. umask: set and get file umask(2) 

mask, umask: set file-creation mode . . . umask (1) 

umount: unmount a file system. . . uraount(2) 

UNIX system, uname: get name of current .... uname{2) 

UNIX system, uname: print home of current . . . uname (1) 

file, unget: undo a previous get of an SCCS . . unget(l) 

an SCCS file, unget: undo a previous get of . . . unget (1) 
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into input stream, ungetc: push character back .... ungetc(3S) 

drand48: generate uniformly distributed/ drand48(3C) 

a file, uniq: report repeated lines in . . uniq(l) 

mktemp: make a unique file name mktemp(3C) 

acu: Automatic Call Unit (ACU) interface acu(7) 

units: conversion program units(l) 

and boot procedures, boot: UNIX system startup boot(8) 

execution, uux: UNIX-to-UNIX system command .... uux(lCF) 

uuto: public UNIX-to-UNIX system file copy. . . uuto(lC) 

entry, unlink: remove directory unlink(2) 

link: exercise link and unlink system calls link(lM) 

umount: unmount a file system umount(2) 

times of a file, touch: update access and modification . . touch(l) 

of programs, make: maintain, update, and regenerate groups . . . make(l) 

bdblk: print, initialize, update bad information ...... bdblk(lM) 

Isearch: linear search and update lsearch(3C) 

sync: update super-block sync(2) 

sync: update the super block sync(l) 

du: summarize disk usage du(l) 

Stat: statistical network useful with graphical/ stat(lG) 

id: print user and group IDs and names. . . id(l) 

setuid, setgid: set user and group IDs setuid{2) 

crontab: user crontab file crontab(l) 

character login name of the user, cuserid: get cuserid(3S) 

environ: user environment environ(5) 

disk accounting data by user ID. diskusg: generate .... diskusg(lM) 

getuid: get user IDs getuid(2) 

ulimit: get and set user limits ulimit(2) 

logname: return login name of user. logname(3X) 

become super-user or another user, su: su(l) 

the utmp file of the current user, /find the slot in ttyslot{3C) 

write: write to another user write(l) 

mail: send mail to users or read mail mail(l) 

wall: write to all users wall(lM) 

fuser: identify processes using a file or file/ fuser(lM) 

statistics, ustat: get file system ustat(2) 

gutil: graphical utilities gutil(lG) 

modification times, utime: set file access and .... utime(2) 

utmp: utmp and wtmp entry formats. . . . utmp (4) 

getutent: access utemp file entry getut(3C) 

ttyslot: find the slot in the utmp file of the current user. . . ttyslot(3C) 

formats, utmp: utmp and wtmp entry utmp (4) 

clean-up. uuclean: uucp spool directory . . . uuclean(lM) 

uusub: monitor uucp network uusub(lM) 

uuclean: uucp spool directory clean-up. . . uuclean{lM) 

control, uustat: uucp status inquiry and job .... uustat(lC) 

system copy, uucp: UNIX system to UNIX uucp(lC) 

and job control, uustat: uucp status inquiry .... uustat (IC) 
uusub: monitor uucp network. . . . uusub(lM) 

system file copy, uuto: public UNIX-to-UNIX uuto(lC) 

command execution, uux: UNIX-to-UNIX system uux(lC) 

val: validate SCCS file val(l) 

val: validate SCCS file val(l) 

provide truth value about processor type. . . . machid(l) 

abs: return integer absolute value abs(3C) 

abs: Fortran absolute value abs(3F) 

getenv: return value for environment name. . . . getenv(3C) 

ceiling, remainder, absolute value functions, /floor, floor (3M) 

putenv: change or add value to environment putenv(3C) 

values, values: machine-dependent values (5) 



35 



true: provide truth values true(l) 

values: machine-dependent values values (5) 

/print formatted output of a varargs argument list vprintf(3S) 

/print formatted output of a varargs argument list vprintf(3X) 

argument list, varargs: handle variable varargs (5) 

varargs: handle variable argument list varargs (5) 

return Fortran environment variable, getenv: getenv(3F) 

vc: version control vc(l) 

option letter from argument vector, getopt: get getopt(3C) 

assert: verify program assertion assert(3X) 

vc: version control vc(l) 

get: get a version of an SCCS file get(l) 

sccsdiff: compare two versions of an SCCS file sccsdiff(l) 

vi: screen-oriented editor .... vi(l) 
with label checking, volcopy: copy file systems .... volcopy(lM) 

file system: format of system volume fs(4) 

output of a varargs argument/ vprintf: print formatted vprintf(3S) 

output of a varargs argument/ vprintf: print formatted vprintf (3X) 

process, wait: await completion of wait(l) 

or terminate, wait: wait for child process to stop . . wait(2) 
to stop or terminate, wait: wait for child process . . . wait (2) 

ftw: walk a file tree ftw(3C) 

wail: write to all users wall(lM) 

wc: word count wc{l) 

what: identify SCCS files what(l) 

signal, signal: specify what to do upon receipt of a ... signal (2) 
crashes, crash: what to do when the system .... crash(8) 

whodo: who is doing what whodo(lM) 

who: who is on the system who(l) 

who: who is on the system. .... who(l) 
whodo: who is doing what. .... whodo (IM) 

cd: change working directory cd(l) 

chdir: change working directory chdir(2) 

get path-name of current working directory, getcwd: .... getcwd(3C) 

pwd: working directory name pwd(l) 

write: write on a file write(2) 

putpwent: write password file entry putpwent(3C) 

wall: write to all users. wall(lM) 

write: write to another user write{l) 

write: write on a file write(2) 

write: write to another user. . . write{l) 

open: open for reading or writing open(2) 

utmp: utmp and wtmp entry formats utmp(4) 

list(s) and execute command, xargs: construct argument xargs(l) 

functions, and, or, xor, not: Fortran boolean bool(3F) 

j0, jl, jn, y0, yl, yn: Bessel functions. . . bessel(3M) 

j0, jl, jn, y0, yl, yn: Bessel functions bessel {3M) 

compiler-compiler, yaac: yet another yaac(l) 

jOf jlf jn, y0, yl, yn: Bessel functions bessel (3M) 
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NAME 

intro — introduction to system calls and error numbers 

SYNOPSIS 

#include <errno.h> 

DESCRIPTION 

This section describes all of the system calls. Most of these calls have one or 
more error returns. An error condition is indicated by an otherwise impossible 
returned value. This is almost always —1; the individual descriptions specify 
the details. An error number is also made available in the external variable 
errno. Errno is not cleared on successful calls, so it should be tested only after 
an error has been indicated. 

Each system call description attempts to list all possible error numbers. The 
following is a complete list of the error numbers and their names as defined in 
<errno.h>. 

1 EPERM Not owner 

Typically this error indicates an attempt to modify a file in some way 
forbidden except to its owner or super-user. It is also returned for 
attempts by ordinary users to do things allowed only to the super-user. 

2 ENOENT No such file or directory 

This error occurs when a file name is specified and the file should exist 
but doesn't, or when one of the directories in a path name does not 
exist. 

3 ESRCH No such process 

No process can be found corresponding to that specified by pid in kill 
or ptrace. 

4 EINTR Interrupted system call 

An asynchronous signal (such as interrupt or quit) , which the user has 
elected to catch, occurred during a system call. If execution is 
resumed after processing the signal, it will appear as if the interrupted 
system call returned this error condition. 

5 EIO I/O error 

Some physical I/O error has occurred. This error may in some cases 
occur on a call following the one to which it actually applies. 

6 ENXIO No such device or address 

I/O on a special file refers to a subdevice which does not exist, or 
beyond the limits of the device. It may also occur when, for example, 
a tape drive is not on-line or no disk pack is loaded on a drive. 

7 E2BIG Arg list too long 

An argument list longer than 5,120 bytes is presented to a member of 
the exec family. 

8 ENOEXEC Exec format error 

A request is made to execute a file which, although it has the appropri- 
ate permissions, does not start with a valid magic number (see 
a.ou/(4)). 

9 EBADF Bad file number 

Either a file descriptor refers to no open file, or a read (respectively, 
write) request is made to a file which is open only for writing (respec- 
tively, reading). 

10 ECHILD No child processes 

A wait was executed by a process that had no existing or unwaited-for 
child processes. 
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11 

, 12 

13 
14 
15 
16 

17 
18 
19 

20 

21 
22 

23 

24 

25 
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E AG A IN No more processes 

A fork failed because the system's process table is full or the user is 
not allowed to create any more processes. 

ENOMEM Not enough space 

During an exec, brk, or sbrk, a program asks for more space than the 
system is able to supply. This is not a temporary condition; the max- 
imum space size is a system parameter. The error may also occur if 
the arrangement of text, data, and stack segments requires too many 
segmentation registers, or if there is not enough swap space during a 
fork. 

EACCES Permission denied 

An attempt was made to access a file in a way forbidden by the protec- 
tion system. 

EFAULT Bad address 

The system encountered a hardware fault in attempting to use an argu- 
ment of a system call. 

ENOTBLK Block device required 

A non-block file was mentioned where a block device was required, 
e.g., in mount. 

EBUSY Device or resource busy 

An attempt was made to mount a device that was already mounted or 
an attempt was made to dismount a device on which there is an active 
file (open file, current directory, mounted-on file, active text segment). 
It will also occur if an attempt is made to enable accounting when it is 
already enabled. The device or resource is currently unavailable. 

EEXIST File exists 

An existing file was mentioned in an inappropriate context, e.g., link. 

EXDEV Cross-device link 

A link to a file on another device was attempted. 

ENODEV No such device 

An attempt was made to apply an inappropriate system call to a dev- 
ice; e.g., read a write-only device. 

ENOTDIR Not a directory 

A non-directory was specified where a directory is required, for exam- 
ple in a path prefix or as an argument to chdir (2) . 

EISDIR Is a directory 

An attempt was made to write on a directory. 

EINVAL Invalid argument 

Some invalid argument (e.g., dismounting a non-mounted device; men- 
tioning an undefined signal in signal, or kill; reading or writing a file 
for which Iseek has generated a negative pointer). Also set by the 
math functions described in the (3M) entries of this manual. 

ENFILE File table overflow 

The system file table is full, and temporarily no more opens can be 
accepted. 

EM FILE Too many open files 

No process may have more than 20 file descriptors open at a time. 

ENOTTY Not a character device 

An attempt was made to ioctl(2) a file that is not a special character 
device. 
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26 ETXTBSY Text file busy 

An attempt was made to execute a pure-procedure program that is 
currently open for writing. Also an attempt to open for writing a 
pure-procedure program that is being executed. 

27 EFBIG File too large 

The size of a file exceeded the maximum file size (1,082,201,088 bytes) 
or ULIMIT; see ulimitil). 

28 ENOSPC No space left on device 

During a write to an ordinary file, there is no free space left on the 
device. 

29 ESPIPE Illegal seek 

An Iseek was issued to a pipe. 

30 EROFS Read-only file system 

An attempt to modify a file or directory was made on a device 
mounted read-only. 

31 EMLINK Too many links 

An attempt to make more than the maximum number of links (1000) 
to a file. 

32 EPIPE Broken pipe 

A write on a pipe for which there is no process to read the data. This 
condition normally generates a signal; the error is returned if the signal 
is ignored. 

33 EDOM Math argument 

The argument of a function in the math package (3M) is out of the 
domain of the function. 

34 ERANGE Result too large 

The value of a function in the math package (3M) is not represen table 
within machine precision. 

35 ENOMSG No message of desired type 

An attempt was made to receive a message of a type that does not 
exist on the specified message queue; see msgopil). 

36 EIDRM Identifier Removed 

This error is returned to processes that resume execution due to the 
removal of an identifier from the file system's name space (see 
msgctUl), semctlil), and shmctlil)). 

DEFINITIONS 
Process ID 

Each active process in the system is uniquely identified by a positive integer 
called a process ID. The range of this ID is from 1 to 30,000. 

Parent Process ID 

A new process is created by a currently active process; see forkil). The parent 
process ID of a process is the process ID of its creator. 

Process Group ID 

Each active process is a member of a process group that is identified by a posi- 
tive integer called the process group ID. This ID is the process ID of the group 
leader. This grouping permits the signaling of related processes; see kill (2) . 

Tty Group ID 

Each active process can be a member of a terminal group that is identified by a 
positive integer called the tty group ID. This grouping is used to terminate a 
group of related processes upon termination of one of the processes in the 
group; see exit (2) and signal (2). 



INTRO (2) 



INTRO (2) 



Real User ID and Real Group ID 

Each user allowed on the system is identified by a positive integer called a real 
user ID. 

Each user is also a member of a group. The group is identified by a positive 
integer called the real group ID. 

An active process has a real user ID and real group ID that are set to the real 
user ID and real group ID, respectively, of the user responsible for the creation 
of the process. 

Effective User ID and Effective Group ID 

An active process has an effective user ID and an effective group ID that are 
used to determine file access permissions (see below). The effective user ID and 
effective group ID are equal to the process's real user ID and real group ID 
respectively, unless the process or one of its ancestors evolved from a file that 
had the set-user-ID bit or set-group ID bit set; see exec (2) . 

Super-user 

A process is recognized as a super-user process and is granted special privileges 
if its effective user ID is 0. 

Special Processes 

The processes with a process ID of 0 and a process ID of 1 are special processes 
and are referred to as procO and prod. 

ProcO is the scheduler. Prod is the initialization process iinit). Procl is the 
ancestor of every other process in the system and is used to control the process 
structure. 

File Descriptor 

A file descriptor is a small integer used to do I/O on a file. The value of a file 
descriptor is from 0 to 19. A process may have no more than 20 file descriptors 
(0-19) open simultaneously. A file descriptor is returned by system calls such 
as openil), or piped). The file descriptor is used as an argument by calls such 
as read (2), write (2), ioctlil), and closed). 

File Name 

Names consisting of 1 to 14 characters may be used to name an ordinary file, 
special file or directory. 

These characters may be selected from the set of all character values excluding 
\0 (null) and the ASCII code for / (slash). 

Note that it is generally unwise to use *, ?, [, or 1 as part of file names because 
of the special meaning attached to these characters by the shell. See sh(l). 
Although permitted, it is advisable to avoid the use of unprintable characters in 
file names. 

Path Name and Path Prefix 

A path name is a null-terminated character string starting with an optional 
slash (/), followed by zero or more directory names separated by slashes, 
optionally followed by a file name. 

More precisely, a path name is a null-terminated character string constructed 
as follows: 

< path-name > : := < file-name > | < path-prefix > < file-name > |/ 
<path-prefix>::™<rtprefix> |/<rtprefix> 
<rtprefix>::=<dirname>/| <rtprefix> <dirname>/ 

where <file-name> is a string of 1 to 14 characters other than the ASCII slash 
and null, and <dirname> is a string of 1 to 14 characters (other than the 
ASCII slash and null) that names a directory. 



- 4 - 



INTRO (2) 



INTRO (2) 



If a path name begins with a slash, the path search begins at the root direc- 
tory. Otherwise, the search begins from the current working directory. 

A slash by itself names the root directory. 

Unless specifically stated otherwise, the null path name is treated as if it named 
a non-existent file. 

Directory 

Directory entries are called links. By convention, a directory contains at least 
two links, . and .., referred to as dot and dot -dot respectively. Dot refers to 
the directory itself and dot-dot refers to its parent directory. 

Root Directory and Current Working Directory 

Each process has associated with it a concept of a root directory and a current 
working directory for the purpose of resolving path name searches. The root 
directory of a process need not be the root directory of the root file system. 

File Access Permissions 

Read, write, and execute/search permissions on a file are granted to a process if 
one or more of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches the user ID of the owner 
of the file and the appropriate access bit of the "owner" portion (0700) 
of the file mode is set. 

The effective user ID of the process does not match the user ID of the 
owner of the file, and the effective group ID of the process matches the 
group of the file and the appropriate access bit of the "group" portion 
(070) of the file mode is set. 

The effective user ID of the process does not match the user ID of the 
owner of the file, and the effective group ID of the process does not 
match the group ID of the file, and the appropriate access bit of the 
"other" portion (07) of the file mode is set. 

Otherwise, the corresponding permissions are denied. 

Message Queue Identifier 

A message queue identifier (msqid) is a unique positive integer created by a 
msggetil) system call. Each msqid has a message queue and a data structure 
associated with it. The data structure is referred to as msqid ds and contains 
the following members: 



struct ipc_perm msg_perm; 

ushort msgqnum; 

ushort msgqbytes; 

ushort msgjspid; 

ushort msglrpid; 

time_t msgstime; 

timet msg_rtime; 

timet msgctime; 



/• operation permission struct */ 

/* number of msgs on q */ 

/* max number of bytes on q */ 

/♦ pid of last msgsnd operation */ 

/* pid of last msgrcv operation */ 

/* last msgsnd time */ 

/• last msgrcv time */ 

/* last change time */ 

/* Times measured in sees since */ 

/* 00:00.00 GMT, Jan. 1, 1970 ♦/ 



Msg_perin is an ipc_perm structure that specifies the message operation permis- 
sion (see below). This structure includes the following members: 



ushort 


cuid; 


/* creator user id */ 


ushort 


cgid; 


/♦ creator group id */ 


ushort 


aid; 


/* user id ♦/ 


ushort 


gid; 


/* group id •/ 


ushort 


mode; 


/* r/w permission */ 
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Msgjqnum is the number of messages currently on the queue. Msgjjbytes is 
the maximum number of bytes allowed on the queue. Msgjspid is the process 
id of the last process that performed a msgsnd operation. Msgjrpid is the pro- 
cess id of the last process that performed a msgrcv operation. Msgjstime is the 
time of the last msgsnd operation, msgjrtime is the time of the last msgrcv 
operation, and msgjctime is the time of the last msgctlil) operation that 
changed a member of the above structure. 

Message Operation Permissions 

In the msgopil) and msgctlil) system call descriptions, the permission 
required for an operation is given as "{token}", where "token" is the type of per- 
mission needed interpreted as follows: 



00400 Read by user 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 



Read and Write permissions on a msqid are granted to a process if one or more 
of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches insg_perni.[c]uid in the 
data structure associated with msqid and the appropriate bit of the 
"user" portion (0600) of msgjperiii.mode is set. 

The effective user ID of the process does not match insg_perm.[c]uid 
and the effective group ID of the process matches msg_perm.Iclgid and 
the appropriate bit of the "group" portion (060) of msg_perm,mode is 
set. 

The effective user ID of the process does not match msg_perni.[c]uid 
and the effective group ID of the process does not match 
insg_perin.[c]gid and the appropriate bit of the "other" portion (06) of 
msg_perin.inode is set. 

Otherwise, the corresponding permissions are denied. 

Semaphore Identifier 

A semaphore identifier (semid) is a unique positive integer created by a 
semgetii) system call. Each semid has a set of semaphores and a data struc- 
ture associated with it. The data structure is referred to as semid ds and con- 
tains the following members: 

struct ipc_perm semjperm; /* operation permission struct */ 
ushort sem nsems; /♦ number of sems in set */ 

tim6_t semjotime; /• last operation time */ 

time t sem ctime; /♦ last change time */ 

/• Times measured in sees since ♦/ 
/* 00:00:00 GMT, Jan. 1, 1970 ♦/ 

Sem_penn is an ipc_perm structure that specifies the semaphore operation per- 
mission (see below). This structure includes the following members: 



ushort 


cuid; 


/• 


creator user id */ 


ushort 


cgid; 


/* 


creator group id */ 


ushort 


uid; 


/* 


user id ♦/ 


ushort 


gid; 


/• 


group id •/ 


ushort 


mode; 


/* 


r/a permission */ 



The value of sem nsems is equal to the number of semaphores in the set. Each 
semaphore in the set is referenced by a positive integer referred to as a 
semjium. Sem num values run sequentially from 0 to the value of sem_nsems 
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minus 1 . Semjotime is the time of the last semop (2) operation, and sein_ctime 
is the time of the last semctl (2) operation that changed a member of the above 
structure. 

A semaphore is a data structure that contains the following members: 

ushort semval; /• semaphore value */ 

short sempid; /• pid of last operation */ 

ushort semncnt; /• # awaiting semval > cval ♦/ 

ushort semzcnt; /* # awaiting semval = 0 */ 

Semval is a non-negative integer. Sempid is equal to the process ID of the last 
process that performed a semaphore operation on this semaphore. Semncnt is a 
count of the number of processes that are currently suspended awaiting this 
semaphore's semval to become greater than its current value. Semzcnt is a 
count of the number of processes that are currently suspended awaiting this 
semaphore's semval to become zero. 

Semaphore Operation Permissions 

In the semop (2) and semctl (2) system call descriptions, the permission 
required for an operation is given as "{token}", where "token" is the type of per- 
mission needed interpreted as follows: 

00400 Read by user 

00200 Alter by user 

00060 Read, Alter by group 

00006 Read, Alter by others 

Read and Alter permissions on a semid are granted to a process if one or more 
of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches sem_perm.[c]uid in the 
data structure associated with semid and the appropriate bit of the 
"user" portion (0600) of sem_perm.mode is set. 

The effective user ID of the process does not match sem_perm.[cluid 
and the effective group ID of the process matches sem_perm.[c]gid and 
the appropriate bit of the "group" portion (060) of sem_perm.mode is 
set. 

The effective user ID of the process does not match sem_perm.[c]uid 
and the effective group ID of the process does not match 
semjperm.lcigid and the appropriate bit of the "other" portion (06) of 
sem_perm.mode is set. 

Otherwise, the corresponding permissions are denied. 

Shared Memory Identifier 

A shared memory identifier (shmid) is a unique positive integer created by a 
shmget (2) system call. Each shmid has a segment of memory (referred to as a 
shared memory segment) and a data structure associated with it. The data 
structure is referred to as shmid ds and contains the following members: 



struct 


ipc_perm shm_perm; 


/* 


operation permission struct */ 


int 


shmsegsz; 


/• 


size of segment */ 


ushort 


shmcpid; 


/* 


creator pid •/ 


ushort 


shmjpid; 


/* 


pid of last operation */ 


short 


shm_nattch; 


/• 


number of current attaches •/ 


time_t 


shmatime; 


/• 


last attach time */ 


time_t 


shmjdtime; 


/* 


last detach time */ 


timet 


shmctime; 


/* 


last change time */ 






/♦ 


Times measured in sees since */ 



- 7 - 



INTRO (2) 



INTRO (2) 



/• 00:00:00 GMT, Jan. 1, 1970 •/ 

Shin_perin is an ipc_perm structure that specifies the shared memory operation 
permission (see below). This structure includes the following members: 



ushort 


cuid; 


/• 


creator user id */ 


ushort 


cgid; 


/• 


creator group id */ 


ushort 


uid; 


h 


user id •/ 


ushort 


gid; 


1* 


group id ♦/ 


ushort 


mode; 


1* 


r/w permission ♦/ 



Shmjsegsz specifies the size of the shared memory segment. Shm cpid is the 
process id of the process that created the shared memory identifier. Shmjipid is 
the process id of the last process that performed a shmopil) operation. 
Shmjiattch is the number of processes that currently have this segment 
attached. Shm atime is the time of the last shmat operation, shm dtiine is the 
time of the last shmdt operation, and shni_ctime is the time of the last 
shmctl (2) operation that changed one of the members of the above structure. 

Shared Memory Operation Permissions 

In the shmopil) and shmctl (2) system call descriptions, the permission 
required for an operation is given as "{token)", where "token" is the type of per- 
mission needed interpreted as follows: 



00400 Read by user 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 



Read and Write permissions on a shmid are granted to a process if one or more 
of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches sfain_perin.Ic]uid in the 
data structure associated with shmid and the appropriate bit of the 
"user" portion (0600) of siiinj)ena.inode is set. 

The effective user ID of the process does not match sliinjperin.Ic]uid 
and the effective group ID of the process matches shm_penn.Iclgid and 
the appropriate bit of the "group" portion (060) of shin_penn.mode is 
set. 

The effective user ID of the process does not match shinjperin.[c]uid 
and the effective group ID of the process does not match 
shin_peim.Ic]gid and the appropriate bit of the "other" portion (06) of 
shin_penn.iiiode is set. 

Otherwise, the corresponding permissions are denied. 

SEE ALSO 

close (2), ioctl(2), open (2), pipe (2), read (2), write (2), intro(3). 
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NAME 

access — determine accessibility of a file 

SYNOPSIS 

int access (path, amode) 
char 'path; 
int amode; 

DESCRIPTION 

Path points to a path name naming a file. Access checks the named file for 
accessibility according to the bit pattern contained in amode, using the real 
user ID in place of the effective user ID and the real group ID in place of the 
effective group ID. The bit pattern contained in amode is constructed as fol- 
lows: 

04 read 

02 write 

01 execute (search) 

00 check existence of file 

Access to the file is denied if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] Read, write, or execute (search) permission is 

requested for a null path name. 
[ENOENT] The named file does not exist. 
[EACCES] Search permission is denied on a component of the 

path prefix. 

[EROFS] Write access is requested for a file on a read-only 
file system. 

[ETXTBSY] Write access is requested for a pure procedure 
(shared text) file that is being executed. 

[EACCESS] Permission bits of the file mode do not permit 
the requested access. 

[EFAULT] Path points outside the allocated address 
space for the process. 

The owner of a file has permission checked with respect to the "owner" read, 
write, and execute mode bits Members of the file's group other than the owner 
have permissions checked with respect to the "group" mode bits, and ail others 
have permissions checked with respect to the "other" mode bits. 

RETURN VALUE 

If the requested access is permitted, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

chmod(2), stat(2). 
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NAME 

acct — enable or disable process accounting 

SYNOPSIS 

int acct (path) 
char 'path; 

DESCRIPTION 

Acct is used to enable or disable the system process accounting routine. If the 
routine is enabled, an accounting record will be written on an accounting file 
for each process that terminates. Termination can be caused by one of two 
things: an exit call or a signal; see exit (2) and signal (2). The effective user ID 
of the calling process must be super-user to use this call. 

Path points to a path name naming the accounting file. The accounting file 
format is given in acct (4) . 

The accounting routine is enabled if path is non-zero and no errors occur dur- 
ing the system call. It is disabled if path is zero and no errors occur during the 
system call. 

Acct will fail if one or more of the following are true: 

[EPERM] The effective user of the calling process is not super-user. 

[EBUSY] An attempt is being made to enable accounting when it is 

already enabled. 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] One or more components of the accounting file path name do 
not exist. 

[EACCES] A component of the path prefix denies search permission. 

[EACCES] The file named by path is not an ordinary file. 

[EACCES] Mode permission is denied for the named accounting file. 

[EISDIR] The named file is a directory. 

[EROFSl The named file resides on a read-only file system. 

[EFAULT] Path points to an illegal address. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

exit (2), signal (2), acct (4). 
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NAME 

alarm — set a process alarm clock 

SYNOPSIS 

unsigned alarm (sec) 
unsigned sec; 

DESCRIPTION 

Alarm instructs the alarm clock of the calling process to send the signal 
SIGALRM to the calling process after the number of real time seconds specified 
by sec have elapsed; see signal (2) . 

Alarm requests are not stacked; successive calls reset the alarm clock of the 
calling process. 

If sec is 0, any previously made alarm request is canceled. 
RETURN VALUE 

Alarm returns the amount of time previously remaining in the alarm clock of 
the calling process. 

SEE ALSO 

pause (2), signal (2). 
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NAME 

brk, sbrk — change data segment space allocation 

SYNOPSIS 

int brk (endds) 
char *endds; 

char *sbrk (incr) 
int incr; 

DESCRIPTION 

Brk and sbrk are used to change dynamically the amount of space allocated for 
the calling process's data segment; see exec (2). The change is made by reset- 
ting the process's break value and allocating the appropriate amount of space. 
The break value is the address of the first location beyond the end of the data 
segment. The amount of allocated space increases as the break value increases. 
The newly allocated space is set to zero. 

Brk sets the break value to endds and changes the allocated space accordingly. 

Sbrk adds incr bytes to the break value and changes the allocated space 
accordingly. Incr can be negative, in which case the amount of allocated space 
is decreased. 

Brk and sbrk will fail without making any change in the allocated space if one 
or more of the following are true: 

Such a change would result in more space being allocated than is 
allowed by a system-imposed maximum (see ulimitil)). [ENOMEM] 

Such a change would result in the break value being greater than or 
equal to the start address of any attached shared memory segment (see 
shmop{.'i)). 

RETURN VALUE 

Upon successful completion, brk returns a value of 0 and sbrk returns the old 
break value. Otherwise, a value of —1 is returned and errno is set to indicate 
the error. 

SEE ALSO 

exec (2), shmop(2), ulimit(2). 
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NAME 

chdir — change working directory 

SYNOPSIS 

int chdir (path) 
char 'path; 

DESCRIPTION 

Path points to the path name of a directory. Chdir causes the named directory 
to become the current working directory, the starting point for path searches 
for path names not beginning with /. 

Chdir will fail and the current working directory will be unchanged if one or 
more of the following are true: 

[ENOTDIR] A component of the path name is not a directory. 
[ENOENT] The named directory does not exist. 

[EACCES] Search permission is denied for any component of the path 

name. 

[EFAULT] Path points outside the allocated address space of the process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chroot(2). 
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NAME 

chmod — change mode of file 

SYNOPSIS 

int chmod (path, mode) 
char 'path; 
int mode; 

DESCRIPTION 

Path points to a path name naming a file. Chmod sets the access permission 
portion of the named file's mode according to the bit pattern contained in 
mode. 

Access permission bits are interpreted as follows: 

04000 Set user ID on execution. 

02000 Set group ID on execution. 

01000 Save text image after execution. 

00400 Read by owner. 

00200 Write by owner. 

00100 Execute (search if a directory) by owner. 

00070 Read, write, execute (search) by group. 

00007 Read, write, execute (search) by others. 

The effective user ID of the process must match the owner of the file or be 
super-user to change the mode of a file. 

If the effective user ID of the process is not super-user, mode bit 01000 (save 
text image on execution) is cleared. 

If the effective user ID of the process is not super-user and the effective group 
ID of the process does not match the group ID of the file, mode bit 02000 (set 
group ID on execution) is cleared. 

If an executable file is prepared for sharing then mode bit 01000 prevents the 
system from abandoning the swap-space image of the program-text portion of 
the file when its last user terminates. Thus, when the next user of the file exe- 
cutes it, the text need not be read from the file system but can simply be 
swapped in, saving time. 

Chmod will fail and the file mode will be unchanged if one or more of the fol- 
lowing are true: 

[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied on a component of the path 

prefix. 

[EPERM] The effective user ID does not match the owner of the file and 

the effective user ID is not super-user. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the allocated address space of the process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chown(2), mknod(2). 
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NAME 

chown — change owner and group of a file 

SYNOPSIS 

int chown (path, owner, group) 

char 'path; 

int owner, group; 

DESCRIPTION 

Path points to a path name naming a file. The owner ID and group ID of the 
named file are set to the numeric values contained in owner and group respec- 
tively. 

Only processes with effective user ID equal to the file owner or super-user may 
change the ownership of a file. 

If chown is invoked by other than the super-user, the set-user-ID and set- 
group-ID bits of the file mode, 04000 and 02000 respectively, will be cleared. 

Chown will fail and the owner and group of the named file will remain 
unchanged if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied on a component of the path 

prefix. 

[EPERM] The effective user ID does not match the owner of the file and 

the effective user ID is not super-user. 

[EROFS] The named file resides on a read-only file system. 

[EFAULT] Path points outside the allocated address space of the process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chmod(2). 

chown(l) in the UNIX System V User Reference Manual. 
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NAME 

chroot — change root directory 

SYNOPSIS 

int chroot (path) 
char *path; 

DESCRIPTION 

Path points to a path name naming a directory. Chroot causes the named 
directory to become the root directory, the starting point for path searches for 
path names beginning with /. The user's working directory is unaffected by the 
chroot system call. 

The effective user ID of the process must be super-user to change the root 
directory. 

The .. entry in the root directory is interpreted to mean the root directory itself, 
Thus, .. cannot be used to access files outside the subtree rooted at the root 
directory. 

Chroot will fail and the root directory will remain unchanged if one or more of 
the following are true: 

[ENOTDIR] Any component of the path name is not a directory. 
[ENOENT] The named directory does not exist. 
[EPERM] The efFective user ID is not super-user. 

[EFAULT] Path points outside the allocated address space of the process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —\ 
is returned and errno is set to indicate the error. 

SEE ALSO 

chdir(2). 
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NAME 

close — close a file descriptor 

SYNOPSIS 

int close (fildes) 
int fildes; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup,fcntl, or pipe sys- 
tem call. Close closes the file descriptor indicated by fildes. 

Close will fail if fildes is not a valid op>en file descriptor. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

creat (2), dup(2), exec (2), fcntl(2), open (2), pipe (2). 
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NAME 

creat — create a new file or rewrite an existing one 

SYNOPSIS 

int creat (path, mode) 
char 'path; 
int mode; 

DESGRIPTION 

Creat creates a new ordinary file or prepares to rewrite an existing file named 
by the path name pointed to by path . 

If the file exists, the length is truncated to 0 and the mode and owner are 
unchanged. Otherwise, the file's owner ID is set to the eff"ective user ID, of the 
process the group ID of the process is set to the effective group ID, of the pro- 
cess and the low -order 12 bits of the file mode are set to the value of mode 
modified as follows: 

All bits set in the process's file mode creation mask are cleared. See 
umask (2) . 

The "save text image after execution bit" of the mode is cleared. See 
chmod (2) . 

Upon successful completion, the file descriptor is returned and the file is open 
for writing, even if the mode does not permit writing. The file pointer is set to 
the beginning of the file. The file descriptor is set to remain open across exec 
system calls. See fcntlil). No process may have more than 20 files open 
simultaneously. A new file may be created with a mode that forbids writing. 

Creat will fail if one or more of the following are true: 



[ENOTDIR] 


A component of the path prefix is not a directory. 


[ENOENT] 


A component of the path prefix does not exist. 


[EACCES] 


Search permission is denied on a component of the path 
prefix. 


(ENOENT] 


The path name is null. 


[EACCES] 


The file does not exist and the directory in which the file is to 
be created does not permit writing. 


[EROFS] 


The named file resides or would reside on a read-only file sys- 
tem. 


[ETXTBSY] 


The file is a pure procedure (shared text) file that is being 
executed. 


[EACCES] 


The file exists and write permission is denied. 


[EISDIR] 


The named file is an existing directory. 


[EMFILE] 


Twenty (20) file descriptors are currently open. 


[EFAULT] 


Path points outside the allocated address space of the process. 


[ENFILE] 


The system file table is full. 


RETURN VALUE 





Upon successful completion, a non-negative integer, namely the file descriptor, 
is returned. Otherwise, a value of —1 is returned and errno is set to indicate 
the error. 



SEE ALSO 

chmod(2), close(2), dup(2), fcntl(2), lseek(2), open(2), read(2), umask(2), 
write (2). 
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NAME 

dup — duplicate an open file descriptor 

SYNOPSIS 

int dup (fildes) 
int fildes; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup,fcntl, or pipe sys- 
tem call. Dup returns a new file descriptor having the following in common 
with the original: 

Same open file (or pipe). 

Same file pointer (i.e., both file descriptors share one file pointer). 

Same access mode (read, write or read/write). 

The new file descriptor is set to remain open across exec system calls. See 
fcntl(2). 

The file descriptor returned is the lowest one available. 
Dup will fail if one or more of the following are true: 
[eBADF] Fildes is not a valid open file descriptor. 

[EMFILE] Twenty (20) file descriptors are currently open. 

RETURN VALUE 

Upon successful completion a non-negative integer, namely the file descriptor, is 
returned. Otherwise, a value of —1 is returned and errno is set to indicate the 
error. 

SEE ALSO 

creat (2), close (2), exec (2), fcntl(2), open (2), pipe (2). 
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NAME 

execl, execv, execle, execve, execlp, execvp — execute a file 

SYNOPSIS 

int execl (path, argO, argl, argn, 0) 
char 'path, •argO, *argl, •argn; 

int execv (path, argv) 
char 'path, •argvl 1; 

int execle (path, ai^O, argl, argn, 0, envp) 
char •path, *argO, ♦argl, *argn, ♦envp( 1; 

int execve (path, argv, envp) 
char •path, *argv[ 1, •envpl I; 

int execlp (file, argO, argl, argn, 0) 
char 'file, •argO, •argl, •argn; 

int execvp (file, argv) 
char •file, •argvl I; 

DESCRIPTION 

Exec in all its forms transforms the calling process into a new process. The 
new process is constructed from an ordinary, executable file called the new pro- 
cess file. This file consists of a header (see a.out{A)), a text segment, and a 
data segment. The data segment contains an initialized portion and an unini- 
tialized portion (bss). There can be no return from a successful exec because 
the calling process is overlaid by the new process. 

When a C program is executed, it is called as follows: 

main (argc, ai^, envp) 
int argc; 

char ••argv, ••envp; 

where argc is the argument count and argv is an array of character pointers to 
the arguments themselves. As indicated, argc is conventionally at least one and 
the first member of the array points to a string containing the name of the file. 

Path points to a path name that identifies the new process file. 

File points to the new process file. The path prefix for this file is obtained by a 
search of the directories passed as the environment line "PATH =" (see 
environ (5)) . The environment is supplied by the shell (see shil)^. 

ArgO, argl, argn are pointers to null-terminated character strings. These 
strings constitute the argument list available to the new process. By conven- 
tion, at least argO must be present and point to a string that is the same as 
path (or its last component). 

Argv is an array of character pointers to null-terminated strings. These strings 
constitute the argument list available to the new process. By convention, argv 
must have at least one member, and it must point to a string that is the same 
as path (or its last component) . Argv is terminated by a null pointer. 

Envp is an array of character pointers to null-terminated strings. These strings 
constitute the environment for the new process. Envp is terminated by a null 
pointer. For execl and execv, the C run-time start-off routine places a pointer 
to the environment of the calling process in the global cell: 

extern char ••environ; 
and it is used to pass the environment of the calling process to the new process. 

File descriptors open in the calling process remain open in the new proeess*, 
except for those whose close-on-exec flag is set; see fcntlil). For those fiic 
descriptors that remain open, the file pointer is unchanged. 
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Signals set to terminate the calling process will be set to terminate the new pro- 
cess. Signals set to be ignored by the calling process will be set to be ignored 
by the new process. Signals set to be caught by the calling process will be set 
to terminate new process; see signal (2) . 

If the set -user-ID mode bit of the new process file is set (see chmodil)), exec 
sets the effective user ID of the new process to the owner ID of the new process 
file. Similarly, if the set-group-ID mode bit of the new process file is set, the 
effective group ID of the new process is set to the group ID of the new process 
file. The real user ID and real group ID of the new process remain the same as 
those of the calling process. 

The shared memory segments attached to the calling process will not be 
attached to the new process (see shmopil)). 

Profiling is disabled for the new process; see profil (2) . 

The new process also inherits the following attributes from the calling process: 

nice value (see nice (2)) 

process ID 

parent process ID 

process group ID 

semadj values (see semopiD) 

tty group ID (see exitO) and signal (2)) 

trace flag (see ptracei2) request 0) 

time left until an alarm clock signal (see alarm (2)) 

current working directory 

root directory 

file mode creation mask (see umask(2)) 

file size limit (see ulimit{2)) 

utime, stime, cutime, and cstime (see times (2)) 

Exec will fail and return to the calling process if one or more of the following 
are true: 

[ENOENTl One or more components of the new process path name of the 
file do not exist. 

[ENOTDIR] A component of the new process path of the file prefix is not a 
directory. 

[EACCES] Search permission is denied for a directory listed in the new 

process file's path prefix. 

[EACCES] The new process file is not an ordinary file. 

tEACCES] The new process file mode denies execution permission. 

[ENOEXEC] The exec is not an execlp or execvp , and the new process file 
has the appropriate access permission but an invalid magic 
number in its header. 

[ETXTBSY] The new process file is a pure procedure (shared text) file that 
is currently open for writing by some process. 

tENOMEM) The new process requires more memory than is allowed by the 
system-imposed maximum MAXMEM, 

[E2BIG] The number of bytes in the new process's argument list is 

greater than the system-imposed limit of 5120 bytes. 

[EFAULTl The new process file is not as long as indicated by the size 
values in its header. 

EEFAULT] Path, argv, or envp point to an illegal address. 
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RETURN VALUE 

If exec returns to the calling process an error has occurred; the return value 
will be —I and errno will be set to indicate the error. 

SEE ALSO 

alarm (2), exit (2), fork (2), nice (2), ptrace(2), semop(2), signal(2), times (2), 

ulimit(2), umask(2), a.out(4), environ(5). 

sh(l) in the UNIX System V User Reference Manual. 
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NAME 

exit, exit — terminate process 

SYNOPSIS 

void exit (status) 
int status; 
void exit (status) 
int status; 

DESCRIPTION 

Exit terminates the calling process with the following consequences: 

All of the file descriptors open in the calling process are closed. 

If the parent process of the calling process is executing a wait, it is 
notified of the calling process's termination and the low order eight bits 
(i.e., bits 0377) of status are made available to it; see wait {2). 

If the parent process of the calling process is not executing a wait, the 
calling process is transformed into a zombie process. A zombie process 
is a process that only occupies a slot in the process table. It has no 
other space allocated either in user or kernel space. The process table 
slot that it occupies is partially overlaid with time accounting informa- 
tion (see <sys/proc.h>) to be used by times. 

The parent process ID of all of the calling process's existing child 
processes and zombie processes is set to 1. This means the initializa- 
tion process (see intro{2)) inherits each of these processes. 

Each attached shared memory segment is detached and the value of 
shin_nattach in the data structure associated with its shared memory 
identifier is decremented by 1. 

For each semaphore for which the calling process has set a semadj 
value (see semopil)), that semadj value is added to the semval of the 
specified semaphore. 

If the process has a process, text, or data lock, an unlock is performed 
(see plock (2)). 

An accounting record is written on the accounting file if the system's 
accounting routine is enabled; see acct (2) . 

If the process ID, tty group ID, and process group ID of the calling pro- 
cess are equal, the SIGHUP signal is sent to each process that has a 
process group ID equal to that of the calling process. 

The C function exit may cause cleanup actions before the process exits. The 
function exit circumvents all cleanup. 

SEE ALSO 

acct (2), intro(2), plock (2), semop(2), signal (2), wait (2). 

WARNING 

See WARNING in signal (2). 
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NAME 

fcntl — file control 

SYNOPSIS 

#include <fcntl.h> 

int fcntl (fildes, cmd, arg) 
int fildes, cmd, arg; 

DESCRIPTION 

Fcntl provides for control over open files. Fildes is an open file descriptor 
obtained from a creat, open, dup, fcntl, or pipe system call. 

The commands available are: 

F DUPFD Return a new file descriptor as follows: 

Lowest numbered available file descriptor greater than or 
equal to arg. 

Same open file (or pipe) as the original file. 

Same file pointer as the original file (i.e., both file descriptors 
share one file pointer). 

Same access mode (read, write or read/write). 

Same file status flags (i.e., both file descriptors share the 
same file status flags). 

The close-on-exec flag associated with the new file descriptor 
is set to remain open across execil) system calls. 

F GETFD Get the close-on-exec flag associated with the file descriptor 

fildes. If the low-order bit is 0 the file will remain open 
across exec, otherwise the file will be closed upon execution 
of exec. 

F SETFD Set the close-on-exec flag associated with fildes to the low- 

order bit of arg (0 or 1 as above) . 

F_GETFL Get file status flags. 

F SETFL Set file status flags to arg. Only certain flags can be set; see 

fcntl {5). 

Fcntl will fail if one or more of the following are true: 



[EBADF] Fildes is not a valid open file descriptor. 

[EMFILE] Cmd is F_DUPFD and 20 file descriptors are currently open. 

[EMFILE] Cmd is F_DUPFD and arg is negative or greater than 20. 

RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 



F_DUPFD 
F_GETFD 
F_SETFD 
F_GETFL 
F_SETFL 
Otherwise, a value of 

SEE ALSO 

close (2), exec (2), open (2), fcntl (5) 



A new file descriptor. 

Value of flag (only the low-order bit is defined). 
Value other than —1. 
Value of file flags. 
Value other than —1. 
1 is returned and errno is set to indicate the error. 
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NAME 

fork — create a new process 

SYNOPSIS 

int fork () 

DESCRIPTION 

Fork causes creation of a new process. The new process (child process) is an 
exact copy of the calling process (parent process). This means the child pro- 
cess inherits the following attributes from the parent process: 

environment 

close-on-exec flag (see exec (2)) 

signal handling settings (i.e., SIG_DFL, SIGJNG, function address) 
set-user-ID mode bit 
set-group-ID mode bit 
profiling on/off status 
nice value (see nice (2)) 

all attached shared memory segments (see shmopil)) 
process group ID 

tty group ID (see exit (2) and signaKD) 

trace flag (see ptrace (2) request 0) 

time left until an alarm clock signal (see alarm (,2)) 

current working directory 

root directory 

file mode creation mask (see umask(2)) 
file size limit (see ulimit{2)) 

The child process differs from the parent process in the following ways: 

The child process has a unique process ID. 

The child process has a diff"erent parent process ID (i.e., the process ID 
of the parent process). 

The child process has its own copy of the parent's file descriptors. 
Each of the child's file descriptors shares a common file pointer with 
the corresponding file descriptor of the parent. 

All semadj values are cleared (see semopiD). 

Process locks, text locks and data locks are not inherited by the child 
(see plocki2)). 

The child process's utime, stime, cutime, and cstime are set to 0. The 
time left until an alarm clock signal is reset to 0. 

Fork will fail and no child process will be created if one or more of the follow- 
ing are true: 

[EAGAINl The system-imposed limit on the total number of processes 
under execution would be exceeded. 

[EAGAINl The system-imposed limit on the total number of processes 
under execution by a single user would be exceeded. 
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RETURN VALUE 

Upon successful completion, fork returns a value of 0 to the child process and 
returns the process ID of the child process to the parent process. Otherwise, a 
value of —1 is returned to the parent process, no child process is created, and 
errno is set to indicate the error. 

SEE ALSO 

exec(2), nice(2), plock(2), ptrace(2), semop(2), shmop(2), signal(2), times(2), 
ulimit(2), umask(2), vk'ait(2). 
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NAME 

getpid, getpgrp, getppid - get process, process group, and parent process IDs 

SYNOPSIS 

int getpid 0 

int getpgrp 0 

int getppid 0 

DESCRIPTION 

Getpid returns the process ID of the caUing process. 

Getpgrp returns the process group ID of the calling process. 
Getppid returns the parent process ID of the calling process. 
SEE ALSO 

exec (2), fork (2), intro(2), setpgrp(2), signal (2). 
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NAME 

getuid, geteuid, getgid, getegid — get real user, effective user, real group, and 
effective group IDs 

SYNOPSIS 

unsigned short getuid () 

unsigned short geteuid 0 

unsigned short getgid 0 

unsigned short getegid 0 

DESCRIPTION 

Getuid returns the real user ID of the calling process. 

Geteuid returns the effective user ID of the calling process. 

Getgid returns the real group ID of the calling process. 

Getegid returns the effective group ID of the calling process. 

SEE ALSO 

intro(2), setuid(2). 
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NAME 

ioctl — control device 

SYNOPSIS 

ioctl (fildes, request, arg) 
int fildes, request; 

DESCRIPTION 

Ioctl performs a variety of functions on character special files (devices). The 
write-ups of various devices in Section 7 of the UNIX System V Administrator 
Reference Manual discuss how ioctl applies to them. 

Ioctl will fail if one or more of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[ENOTTY] Fildes is not associated with a character special device. 

[EINVAL] Request or arg is not valid. See Section 7 of the UNIX Sys- 
tem V Administrator Reference Manual. 

[EINTR] A signal was caught during the ioctl system call. 

RETURN VALUE 

If an error has occurred, a value of —1 is returned and errno is set to indicate 
the error. 

SEE ALSO 

termio(7) in the UNIX System V Administrator Reference Manual. 
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NAME 

kill — send a signal to a process or a group of processes 

SYNOPSIS 

int kill (pid, sig) 
int pid, sig; 

DESCRIPTION 

Kill sends a signal to a process or a group of processes. The process or group 
of processes to which the signal is to be sent is specified by pid. The signal 
that is to be sent is specified by sig and is either one from the list given in sig- 
nal (2), or 0. If sig is 0 (the null signal), error checking is performed but no 
signal is actually sent. This can be used to check the validity of pid. 

The real or effective user ID of the sending process must match the real or 
effective user ID of the receiving process, unless the effective user ID of the 
sending process is super-user. 

The processes with a process ID of 0 and a process ID of 1 are special processes 
(see introil)) and will be referred to below as procO and prod, respectively. 

If pid is greater than zero, sig will be sent to the process whose process ID is 
equal to pid. Pid may equal 1. 

If pid is 0, sig will be sent to all processes excluding procO and prod whose 
process group ID is equal to the process group ID of the sender. 

If pid is —1 and the effective user ID of the sender is not super-user, sig will be 
sent to all processes excluding procO and prod whose real user ID is equal to 
the effective user ID of the sender. 

If pid is —1 and the effective user ID of the sender is super-user, sig will be 
sent to all processes excluding procO and prod. 

If pid is negative but not —1, sig will be sent to all processes whose process 
group ID is equal to the absolute value of pid. 

Kill will fail and no signal will be sent if one or more of the following are true: 
[EINVAL] Sig is not a valid signal number. 
[EINVAL] Sig is SIGKILL and pid is 1 (procl). 

[ESRCH] No process can be found corresponding to that specified by 

pid. 

[EPERM] The user ID of the sending process is not super-user, and its 
real or effective user ID does not match the real or effective 
user ID of the receiving process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

getpid(2), setpgrp(2), signal (2). 

kill(l) in the UNIX System V User Reference Manual. 
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NAME 



link — link to a file 



SYNOPSIS 

int link (pathl, path2) 
char 'pathl, 'pathZ; 

DESCRIPTION 

Pathl points to a path name naming an existing file. Path2 points to a path 
name naming the new directory entry to be created. Link creates a new link 
(directory entry) for the existing file. 

Link will fail and no link will be created if one or more of the following are 
true: 

[ENOTDIR] A component of either path prefix is not a directory. 
[ENOENT] A component of either path prefix does not exist. 
[EACCES] A component of either path prefix denies search permission. 

[ENOENT] The file named by pathl does not exist. 
[EEXIST] The Hnk named by path2 exists. 

[EPERM] The file named by pathl is a directory and the effective user 

ID is not super-user. 

[EXDEV] The link named by path2 and the file named by pathl are on 

different logical devices (file systems). 

[ENOENT] Path2 points to a null path name. 

[EACCES] The requested link requires writing in a directory with a mode 

that denies write permission. 

[EROFS] The requested link requires writing in a directory on a read- 

only file system. 

[EFAULT] Path points outside the allocated address space of the process. 

[EMLINK] The maximum number of links to a file would be exceeded. 
RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

unlink(2) . 
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NAME 

lockf — record and file locking 

SYNOPSIS 

int lockf (fildes, request, size) 
int fildes, request; 
long size; 

DESCRIPTION 

Lockf provides a set of primitives for locking segments of a file. A file segment is an arbitrary 
length region within a file defined by a starting file address (the current read /write pointer) 
and a size (an argument to the locking call). The smallest valid segment size is one byte, the 
largest is the entire file. After a successful lockf call, no other process can read or write any 
part of the segment until it is explicitly unlocked or the file is closed. 

The manner in which file segments are locked is analogous to the way they are read and 
written. 

Fildes is a file descriptor as returned from a successful open, creat, or dup call. 
Request is: 

0 The file segment is unlocked. The segment need not be an exact match to the call that 
locked it. In other words, large segments can be unlocked in small chunks and a 
number of small segments can be unlocked with a single 'unlock' call whose size 
encompasses them all. 

1 The file segment is locked. The issuing process will be put to sleep until the lock can 
be obtained. 

2 The file segment is tested for a locked condition and locked if currently available. If 
the segment is already locked by another process, an error condition is raised and 
return is immediate. 

Size is a long byte count. A size of -IL means "until the end of the file." The start of the 
segment is the implicitly known read/ write pointer returned from a successful Iseek call. 
Therefore, to lock the entire file would require setting the read / write pointer to 0 and calling 
lockf with a size of -IL. 
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Lock/ will fail if one of the following are true: 

• Fildes is not a valid file descriptor. [EACCES] 

• The user does not have write permission on the file. [EACCES] 

• The test and lock form was used and the segment was already locked by another 
process. [EACCES] 

• An attempt at locking caused a potential deadlock situation, that is, the lock table is 
full or a blocked condition would produce a circular list of processes waiting for 
locks. [EDEADLOCK] 

The file need not be opened for writing, yet write permission on the file is required to make use 
of lockf. This restriction stops lock/from disabling the system by locking system maintenance 
files such as /etc/passwd. 

Child processes do not inherit locks on open files, but locks are maintained across execs. All 
locks are removed upon process termination. 

There are a fixed number of total locks per system, but no hmit per process. Therefore, careful 
and selective use of lockf is recommended if other local applications also make use of this 
facility. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of-1 is returned and 
errno is set to indicate the error. 

SEE ALSO 

intro (2), open (2), read (2), write (2), Iseek (2) 
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NAME 

Iseek — move read/write file pointer 

SYNOPSIS 

long Iseek (fildes, offset, whence) 
int fildes; 
long offset; 
int whence; 

DESCRIPTION 

Fildes is a file descriptor returned from a creat, open, dup, or fcntl system call. 
Lseek sets the file pointer associated with fildes as follows: 

If whence is 0, the pjointer is set to offset bytes. 

If whence is 1, the pointer is set to its current location plus offset. 

If whence is 2, the pointer is set to the size of the file plus offset. 

Upon successful completion, the resulting pointer location, as measured in bytes 
from the beginning of the file, is returned. 

Lseek will fail and the file pointer will remain unchanged if one or more of the 
following are true: 

[EBADF] Fildes is not an open file descriptor. 

[ESPIPE] Fildes is associated with a pipe or fifo. 

[EINVAL and SIGSYS signal] 

Whence is not 0, 1, or 2. 

[EINVAL] The resulting file pointer would be negative. 

Some devices are incapable of seeking. The value of the file pointer associated 
with such a device is undefined. 

RETURN VALUE 

Upon successful completion, a non-negative integer indicating the file pointer 
value is returned. Otherwise, a value of —1 is returned and errno is set to indi- 
cate the error. 

SEE ALSO 

creat (2), dup (2), fcntl (2), open (2). 
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NAME 

mknod — make a directory, or a special or ordinary file 

SYNOPSIS 

int mknod (path, mode, dev) 
char 'path; 
int mode, dev; 

DESCRIPTION 

Mknod creates a new file named by the path name pointed to by path. The 
mode of the new file is initialized from mode, where the value of mode is 
interpreted as follows: 

0170000 file type; one of the following: 

0010000 fifo special 

0020000 character special 

0040000 directory 

0060000 block special 

0100000 or 0000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 
0000777 access permissions; constructed from the following 

0000400 read by owner 

0000200 write by owner 

0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 

The owner ID of the file is set to the effective user ID of the process. The 
group ID of the file is set to the effective group ID of the process. 

Values of mode other than those above are undefined and should not be used. 
The low-order 9 bits of mode are modified by the process's file mode creation 
mask: all bits set in the process's file mode creation mask are cleared. See 
umaskil). If mode indicates a block or character special file, dev is a 
configuration-dependent specification of a character or block I/O device. If 
mode does not indicate a block special or character special device, dev is 
ignored. 

Mknod may be invoked only by the super-user for file types other than FIFO 
special. 

Mknod will fail and the new file will not be created if one or more of the fol- 
lowing are true 

[EPERM] 

[ENOTDIR] 

[ENOENT] 

[EROFS] 

[EEXIST] 
[EFAULTl 



The effective user ID of the process is not super-user. 

A component of the path prefix is not a directory. 

A component of the path prefix does not exist. 

The directory in which the file is to be created is located on a 
read-only file system. 

The named file exists. 

Path points outside the allocated address space of the process. 
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RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chniod(2), exec (2), umask(2), fs(4). 

mkdir(l) in the UNIX System V User Reference Manual. 
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NAME 

mount — mount a file system 

SYNOPSIS 

int mount (spec, dir, rwflag) 
char 'spec, 'dir; 
int rwflag; 

DESCRIPTION 

Mount requests that a removable file system contained on the block special file 
identified by spec be mounted on the directory identified by dir. Spec and dir 
are pointers to path names. 

Upon successful completion, references to the file dir will refer to the root 
directory on the mounted file system. 

The low-order bit of rwflag is used to control write permission on the mounted 
file system; if 1, writing is forbidden, otherwise writing is permitted according 
to individual file accessibility. 

Mount may be invoked only by the super-user. 

Mount will fail if one or more of the following are true: 

[EPERM] The effective user ID is not super-user. 

[ENOENTl Any of the named files does not exist. 

[ENOTDIR] A component of a path prefix is not a directory. 

[ENOTBLK] Spec is not a block special device. 

[ENXIO] The device associated with spec does not exist. 

[ENOTDIR] Dir is not a directory. 

[EFAULT] Spec or dir points outside the allocated address space of the 

process. 

[EBUSY] Dir is currently mounted on, is someone's current working 

directory, or is otherwise busy. 

[EBUSY] The device associated with spec is currently mounted. 

[EBUSY] There are no more mount table entries. 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

umount(2). 
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NAME 

msgctl — message control operations 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/msg.h> 

int msgctl (msqid, cmd, buf) 
int msqid, cmd; 
struct msqid ds *buf; 

DESCRIPTION 

Msgctl provides a variety of message control operations as specified by cmd. 
The following cmds are available: 



IPC STAT 



IPC SET 



Place the current value of each member of the data structure 
associated with msqid into the structure pointed to by buf. 
The contents of this structure are defined in intro (2) . {READ} 



Set the value of the following members of the data structure 
associated with msqid to the corresponding value found in the 
structure pointed to by buf: 
msg_perm.uid 
msgjperm.gid 

msg_perm.mode /* only low 9 bits */ 
msgqbytes 

This cmd can only be executed by a process that has an 
effective user ID equal to either that of super user or to the 
value of msgjierm.uid in the data structure associated with 
msqid. Only super user can raise the value of msg_qbytes. 

IPC RMID Remove the message queue identifier specified by msqid from 
the system and destroy the message queue and data structure 
associated with it. This cmd can only be executed by a pro- 
cess that has an effective user ID equal to either that of super 
user or to the value of msg_perm.uid in the data structure 
associated with msqid. 

Msgctl will fail if one or more of the following are true: 

[EINVAL] Msqid is not a valid message queue identifier. 

[EINVAL] Cmd is not a valid command. 

[EACCES] Cmd is equal to IPC_STAT and {READ) operation permission 

is denied to the calling process (see int roil)). 

[EPERM] Cmd is equal to IPC_RMID or IPC_SET. The effective user ID 

of the calling process is not equal to that of super user and it 
is not equal to the value of msgj>erm.uid in the data structure 
associated with msqid. 

[EPERM] Cmd is equal to IPC_SET, an attempt is being made to 

increase to the value of msg_qbytes, and the effective user ID 
of the calling process is not equal to that of super user. 

[EFAULTl Buf points to an illegal address. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

intro (2), msgget(2), msgop(2). 
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NAME 

msgget — get message queue 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/msg.h> 

int msgget (key, msgflg) 
keyt key; 
int msgflg; 

DESCRIPTION 

Msgget returns the message queue identifier associated with key. 

A message queue identifier and associated message queue and data structure 
(see introil)) are created for key if one of the following are true: 

10 Key is equal to IPC_PRIVATE. 

Key does not already have a message queue identifier associated with 
it, and {msgflg & IPC_CREAT) is "true". 

Upon creation, the data structure associated with the new message queue 
identifier is initialized as follows: 

Msgjperm.cuid, msgj>erm.uid, msg_perm.cgid, and msg_perm.gid are 

set equal to the effective user ID and effective group ID, respectively, of 
the calling process. 

The low-order 9 bits of msg_perm.mode are set equal to the low-order 9 
bits of msgflg. 

Msg_qnum, msgjspid, msgjrpid, msg_stime, and msgjrtime are set 

equal to 0. 

Msg_ctime is set equal to the current time. 
Msgjqbytes is set equal to the system limit. 
Msgget will fail if one or more of the following are true: 

[EACCES] A message queue identifier exists for key, but operation per- 

mission (see introil)) as specified by the low-order 9 bits of 
msgflg would not be granted. 

[ENOENT] A message queue identifier does not exist for key and (msgflg 
& IPC_CREAT) is "false". 

[ENOSPC] A message queue identifier is to be created but the system- 

imposed limit on the maximum number of allowed message 
queue identifiers system wide would be exceeded. 

[EEXIST] A message queue identifier exists for key but ( (.msgflg & 

IPC GREAT) & ( msgflg & IPC EXCL) ) is "true". 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely a message queue 
identifier, is returned. Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

intro(2), msgctl(2), msgop(2). 
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NAME 

msgop — message operations 

SYNOPSIS 

#inciude <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/insg.h> 

int msgsnd (msqid, msgp, msgsz, msgflg) 
int msqid; 

struct msgbuf *msgp; 
int msgsz, msgflg; 

int msgrcv (msqid, msgp, msgsz, msgtyp, msgflg) 
int msqid; 

struct msgbuf *msgp; 
int msgsz; 
long msgtyp; 
int msgflg; 

DESCRIPTION 

Msgsnd is used to send a message to the queue associated with the message 
queue identifier specified by msqid. {WRITE} Msgp points to a structure con- 
taining the message. This structure is composed of the following members: 

long mtype; /* message type */ 

char mtext[]; /* message text */ 

Mtype is a positive integer that can be used by the receiving process for mes- 
sage selection (see msgrcv belowA Mtext is any text of length msgsz bytes. 
Msgsz can range from 0 to a system-imposed maximum. 

Msgflg specifies the action to be taken if one or more of the following are true: 

The number of bytes already on the queue is equal to msg_qbytes (see 
intra (2)). 

The total number of messages on all queues system-wide is equal to the 
system-imposed limit. 

These actions are as follows: 

If {msgflg & IPC_N0WAIT) is "true", the message will not be sent and 
the calling process will return immediately. 

If {msgflg & IPC_N0WAIT) is "false", the calling process will suspend 
execution until one of the following occurs: 

The condition responsible for the suspension no longer exists, 
in which case the message is sent. 

Msqid is removed from the system (see msgctl{2)). When 
this occurs, errno is set equal to EIDRM, and a value of — 1 is 
returned. 

The calling process receives a signal that is to be caught. In 
this case the message is not sent and the calling process 
resumes execution in the manner prescribed in signal {!)). 

Msgsnd will fail and no message will be sent if one or more of the following are 
true: 

[EINVAL] Msqid is not a valid message queue identifier. 

[EACCES] Operation permission is denied to the calling process (see 

intro{2)). 
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[EINVAL] 



Mtype is less than 1. 



[EAGAIN] 



The message cannot be sent for one of the reasons cited above 
and imsgflg & IPC_N0WAIT) is "true". 



[EINVAL] 



Msgsz is less than zero or greater than the system-imposed 
limit. 



[EFAULT] 



Msgp points to an illegal address. 



Upon successful completion, the following actions are taken with respect to the 
data structure associated with msqid (see intro (2)). 

Msgjqnum is incremented by 1. 

Msg lspid is set equal to the process ID of the calling process. 

Msgjstime is set equal to the current time. 

Msgrcv reads a message from the queue associated with the message queue 
identifier specified by msqid and places it in the structure pointed to by msgp. 
{READ} This structure is composed of the following members: 

long mtype; /• message type */ 

char mtext[]; /* message text */ 

Mtype is the received message's type as specified by the sending process. 
Mtext is the text of the message. Msgsz specifies the size in bytes of mtext. 
The received message is truncated to msgsz bytes if it is larger than msgsz and 
imsgflg & MSG NOERROR) is "true". The truncated part of the message is 
lost and no indication of the truncation is given to the calling process. 

Msgtyp specifies the type of message requested as follows: 

If msgtyp is equal to 0, the first message on the queue is received. 

If msgtyp is greater than 0, the first message of type msgtyp is 
received. 

If msgtyp is less than 0, the first message of the lowest type that is less 
than or equal to the absolute value of msgtyp is received. 

Msgflg specifies the action to be taken if a message of the desired type is not 
on the queue. These are as follows: 

If {msgflg & IPC_N0WAIT) is "true", the calling process will return 
immediately with a return value of —1 and errno set to ENOMSG. 

If imsgflg & IPC_N0WAIT) is "false", the calling process will suspend 
execution until one of the following occurs: 



A message of the desired type is placed on the queue. 

Msqid is removed from the system. When this occurs, errno 
is set equal to EIDRM, and a value of — 1 is returned. 

The calling process receives a signal that is to be caught. In 
this case a message is not received and the calling process 
resumes execution in the manner prescribed in signal il)). 



Msgrcv will fail and no message will be received if one or more of the following 
are true: 



[EINVAL] 
[EACCES] 
[EINVAL] 



Msqid is not a valid message queue identifier. 
Operation permission is denied to the calling process. 
Msgsz is less than 0. 

Mtext is greater than msgsz and imsgflg & 1VISG_N0ERR0R) 
is "false". 



[E2BIG] 
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[ENOMSG] The queue does not contain a message of the desired type and 
(msgtyp & IPC_N0WAIT) is "true". 

[EFAULT] Msgp points to an illegal address. 

Upon successful completion, the following actions are taken with respect to the 
data structure associated with msqid (see intro (2)). 

Msgjqnum is decremented by 1 . 

Msg_Irpid is set equal to the process ID of the calling process. 
Msg_rtiine is set equal to the current time. 
RETURN VALUES 

If msgsnd or msgrcv return due to the receipt of a signal, a value of —1 is 
returned to the calling process and errno is set to EINTR. If they return due to 
removal of msqid from the system, a value of —1 is returned and errno is set to 
EIDRM. 

Upon successful completion, the return value is as follows: 
Msgsnd returns a value of 0. 

Msgrcv returns a value equal to the number of bytes actually placed 
into mtext. 

Otherwise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

intro (2), msgctl(2), msgget(2), signal (2), 
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NAME 

nice — change priority of a process 

SYNOPSIS 

int nice (incr) 
int incr; 

DESCRIPTION 

Nice adds the value of incr to the nice value of the calling process. A process's 
nice value is a positive number for which a more positive value results in lower 
CPU priority. 

A maximum nice value of 39 and a minimum nice value of 0 are imposed by 
the system. Requests for values above or below these limits result in the nice 
value being set to the corresponding limit. 

[EPERM] Nice will fail and not change the nice value if incr is negative 

or greater than 40 and the effective user ID of the calling pro- 
cess is not super-user. 

RETURN VALUE 

Upon successful completion, nice returns the new nice value minus 20. Other- 
wise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec (2). 

nice(l) in the UNIX System V User Reference Manual. 
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NAME 

open — open for reading or writing 

SYNOPSIS 

#include <fcntl.h> 

int open (path, oflag [ , mode ] ) 

char *path; 

int oflag, mode; 

DESCRIPTION 

Path points to a path name naming a file. Open opens a file descriptor for the 
named file and sets the file status flags according to the value of oflag. Oflag 
values are constructed by or-ing flags from the following list (only one of the 
first three flags below may be used) : 

O RDONLY Open for reading only. 

O WRONLY Open for writing only. 

O RDWR Open for reading and writing. 

O NDELAY This flag may aff'ect subsequent reads and writes. See read (2) 
and write (2). 

When opening a FIFO with O RDONLY or 0_WRONLY set: 

If O NDELAY is set: 

An open for reading-only will return without delay. 
An open for writing-only will return an error if no pro- 
cess currently has the file open for reading. 

If O NDELAY is clear: 

An open for reading-only will block until a process 
opens the file for writing. An open for writing-only 
will block until a process opens the file for reading. 

When opening a file associated with a communication line: 

If 0_NDELAY is set: 

The open will return without waiting for carrier. 
If O NDELAY is clear: 

The open will block until carrier is present. 

0_APPEND If set, the file pointer will be set to the end of the file prior to 
each write. 

O CREAT If the file exists, this flag has no eff'ect. Otherwise, the owner 

ID of the file is set to the eff"ective user ID of the process, the 
group ID of the file is set to the eff"ective group ID of the pro- 
cess, and the low-order 12 bits of the file mode are set to the 
value of mode modified as follows (see creatil)): 

All bits set in the file mode creation mask of the pro- 
cess are cleared. See umaskil). 

The "save text image after execution bit" of the mode 
is cleared. Seechmodil). 

0_TRUNC If the file exists, its length is truncated to 0 and the mode and 
owner are unchanged. 

0_EXCL If O EXCL and 0_CREAT are set, open will fail if the file 

exists. 
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The file pointer used to mark the current position within the file is set to the 
beginning of the file. 

The new file descriptor is set to remain open across exec system calls. See 
fcntlil). 

The named file is opened unless one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] 0_CREAT is not set and the named file does not exist. 

[EACCES] A component of the path prefix denies search permission. 

[EACCESl Oflag permission is denied for the named file. 

[EISDIR] The named file is a directory and oflag is write or read/write. 

[EROFS] The named file resides on a read-only file system and oflag is 

write or read/write. 

[EMFILE] Twenty (20) file descriptors are currently open. 

[ENXIO] The named file is a character special or block special file, and 

the device associated with this special file does not exist. 

[ETXTBSY] The file is a pure procedure (shared text) file that is being 
executed and oflag is write or read/write. 

[EFAULT] Path points outside the allocated address space of the process. 

[EEXIST] O CREAT and 0_EXCL are set, and the named file exists. 

[ENXIO] 0_NDELAY is set, the named file is a FIFO, 0_WRONLY is 

set, and no process has the file open for reading. 

[EINTR] A signal was caught during the open system call. 

[ENFILE] The system file table is full. 

RETURN VALUE 

Upon successful completion, the file descriptor is returned. Otherwise, a value 
of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

chmod(2), close (2), creat(2), dup(2), fcntl(2), lseek(2), read (2), umask(2), 
write (2). 
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NAME 

pause — suspend process until signal 

SYNOPSIS 

pause 0 

DESCRIPTION 

Pause suspends the calling process until it receives a signal. The signal must 
be one that is not currently set to be ignored by the calling process. 

If the signal causes termination of the calling process, pause will not return. 

If the signal is caught by the calling process and control is returned from the 
signal-catching function (see signalil)), the calling process resumes execution 
from the point of suspension; with a return value of —1 from pause and errno 
set to EINTR. 

SEE ALSO 

alarm(2), kill(2), signal(2), wait(2). 
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NAME 

pipe — create an interprocess channel 

SYNOPSIS 

int pipe (fildes) 
int fildes[2l; 

DESCRIPTION 

Pipe creates an I/O mechanism called a pipe and returns two file descriptors, 
fildes{Q\ and fildes[\\. FildeslO] is opened for reading and fildesll] is opened 
for writing. 

Up to 5120 bytes of data are buffered by the pipe before the writing process is 
blocked. A read only file descriptor fildeslO] accesses the data written to 
fildesll] on a first-in-first-out (FIFO) basis. 

[EMFILE] Pipe will fail if 19 or more file descriptors are currently open. 

[ENFILEl The system file table is full. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

read (2), write(2). 

sh(l) in the UNIX System V User Reference Manual. 
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NAME 

plock — lock process, text, or data in memory 

SYNOPSIS 

#include <sys/Iock.h> 

int plock (op) 
int op; 

DESCRIPTION 

■ Plock allows the calling process to lock its text segment (text lock), its data 
segment (data lock), or both its text and data segments (process lock) into 
memory. Locked segments are immune to all routine swapping. Plock also 
allows these segments to be unlocked. The effective user ID of the calling pro- 
cess must be super-user to use this call. Op specifies the following: 

PROCLOCK - lock text and data segments into memory (process 
lock) 

TXTLOCK - lock text segment into memory (text lock) 

DATLOCK - lock data segment into memory (data lock) 

UNLOCK - remove locks 

Plock will fail and not perform the requested operation if one or more of the 
following are true: 

[EPERM] The effective user ID of the calling process is not super-user. 

[EINVAL] Op is equal to PROCLOCK and a process lock, a text lock, or a 

data lock already exists on the calling process. 

[EINVAL] Op is equal to TXTLOCK and a text lock, or a process lock 

already exists on the calling process. 

[EINVAL] Op is equal to DATLOCK and a data lock, or a process lock 

already exists on the calling process. 

[EINVAL] Op is equal to UNLOCK and no type of lock exists on the cal- 

ling process. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned to the calling process. 
Otherwise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2). 
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NAME 

profil — execution time profile 

SYNOPSIS 

void profil (bufr, bufsiz, offset, scale) 
char 'buff; 

int bufsiz, offset, scale; 
DESCRIPTION 

Buff points to an area of core whose length (in bytes) is given by bufsiz. After 
this call, the user's program counter (pc) is examined each clock tick (60th 
second); offset is subtracted from it, and the result multiplied by scale. If the 
resulting number corresponds to a word inside buff, that word is incremented. 

The scale is interpreted as an unsigned, fixed-point fraction with binary point at 
the left: 0177777 (octal) gives a 1-1 mapping of pc's to words in buff 011111 
(octal) maps each pair of instruction words together. 02 (octal) maps all 
instructions onto the beginning of buff (producing a non-interrupting core 
clock) . 

Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by 
giving a bufsiz of 0. Profiling is turned off when an exec is executed, but 
remains on in child and parent both after a fork. Profiling will be turned off if 
an update in buff would cause a memory fault. 

RETURN VALUE 
Not defined. 

SEE ALSO 

monitor(3C). 

prof(l) in the UNIX System V User Reference Manual. 
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NAME 

ptrace — process trace 

SYNOPSIS 

int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 

DESCRIPTION 

Ptrace provides a means by which a parent process may control the execution 
of a child process. Its primary use is for the implementation of breakpoint 
debugging; see sdb{\). The child process behaves normally until it encounters 
a signal (see signal (2) for the list), at which time it enters a stopped state and 
its parent is notified via wait (2). When the child is in the stopped state, its 
parent can examine and modify its "core image" using ptrace. Also, the parent 
can cause the child either to terminate or continue, with the possibility of 
ignoring the signal that caused it to stop. 

The request argument determines the precise action to be taken by ptrace and 
is one of the following: 

0 This request must be issued by the child process if it is to be 
traced by its parent. It turns on the child's trace flag that stipu- 
lates that the child should be left in a stopped state upon receipt 
of a signal rather than the state specified by func; see signal{2). 
The pid, addr, and data arguments are ignored, and a return 
value is not defined for this request. Peculiar results will ensue if 
the parent does not expect to trace the child. 

The remainder of the requests can only be used by the parent process. For 
each, pid is the process ID of the child. The child must be in a stopped state 
before these requests are made. 

1, 2 With these requests, the word at location addr in the address 
space of the child is returned to the parent process. If I and D 
space are separated, request 1 returns a word from I space, and 
request 2 returns a word from D space. If I and D space are not 
separated, either request 1 or request 2 may be used with equal 
results. The data argument is ignored. These two requests will 
fail if addr is not the start address of a word, in which case a value 
of -1 is returned to the parent process and the parent's errno is 
set to EIO. 

3 With this request, the word at location addr in the child's USER 
area in the system's address space (see <sys/user.h>) is returned 
to the parent process. Addresses in this area range from 0 to 4096 
on the Altos 3068. The data argument is ignored. This request will 
fail if addr is not the start address of a word or is outside the USER 
area, in which case a value of -1 is returned to the parent process 
and the parent's errno is set to EIO. 

4, 5 With these requests, the value given by the data argument is 
written into the address space of the child at location addr. If I 
and D space are separated, request 4 writes a word into I space, 
and request 5 writes a word into D space. If I and D space are 
not separated, either request 4 or request 5 may be used with 
equal results. Upon successful completion, the value written into 
the address space of the child is returned to the parent. These 
two requests will fail if addr is a location in a pure procedure 
i space. 
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and another process is executing in that space, or addr is not the 
start address of a word. Upon failure a value of —1 is returned 
to the parent process and the parent's errno is set to EIO. 

6 With this request, a few entries in the child's USER area can be 
written. Data gives the value that is to be written and addr is 
the location of the entry. The few entries that can be written 
are: 

the general registers: regs (dO-d7, a0-a7, pc) 
the Processor Status Word : bits (t, x, n, z, v, c) 



7 This request causes the child to resume execution. If the data 
argument is 0, all pending signals including the one that caused 
the child to stop are canceled before it resumes execution. If the 
data argument is a valid signal number, the child resumes execu- 
tion as if it had incurred that signal, and any other pending sig- 
nals are canceled. The addr argument must be equal to 1 for 
this request. Upon successful completion, the value of data is 
returned to the parent. This request will fail if data is not 0 or a 
valid signal number, in which case a value of —1 is returned to 
the parent process and the parent's errno is set to EIO. 

8 This request causes the child to terminate with the same conse- 
quences as exit (2). 



9 This request sets the trace bit in the Processor Status Word of 
the child and then executes the same steps as listed above for 
request 7. The trace bit causes an interrupt upon completion of 
one machine instruction. This effectively allows single stepping 
of the child. On the 3B 20 computer, there is no trace bit; and 
this request returns an error. 

To forestall possible fraud, ptrace inhibits the set-user-id facility on subsequent 
exec (2) calls. If a traced process calls exec, it will stop before executing the 
first instruction of the new image showing signal SIGTRAP. 

GENERAL ERRORS 

Ptrace will in general fail if one or more of the following are true: 

[EIO] Request is an illegal number. 

[ESRCH] Pid identifies a child that does not exist or has not executed a 

ptrace with request 0. 

SEE ALSO 

exec (2), signal(2), wait (2). 

sdb(l) in the UNIX System V User Reference Manual. 
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NAME 

read — read from file 

SYNOPSIS 

int read (fildes, buf, nbyte) 
int fildes; 
char ♦buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup, fcntl, or pipe sys- 
tem call. 

Read attempts to read nbyte bytes from the file associated with fildes into the 
buffer pointed to by buf. 

On devices capable of seeking, the read starts at a position in the file given by 
the file pointer associated with fildes. Upon return from read, the file pointer 
is incremented by the number of bytes actually read. 

Devices that are incapable of seeking always read from the current position. 
The value of a file pointer associated with such a file is undefined. 

Upon successful completion, read returns the number of bytes actually read 
and placed in the buffer; this number may be less than nbyte if the file is asso- 
ciated with a communication fine (see ioctlil) and termioil)), or if the 
number of bytes left in the file is less than nbyte bytes. A value of 0 is 
returned when an end-of-file has been reached. 

When attempting to read from an empty pipe (or FIFO): 

If 0_NDELAY is set, the read will return a 0. 

If ON DELAY is clear, the read will block until data is written to the 
file or the file is no longer open for writing. 

When attempting to read a file associated with a tty that has no data currently 
available: 

If 0_NDELAY is set, the read will return a 0. 

If O NDELAY is clear, the read will block until data becomes avail- 
able. 

Read will fail if one or more of the following are true: 
[EBADF] Fildes is not ^ valid file descriptor open for reading. 

[EFAULT] Buf points outside the allocated address space. 

[EINTR] A signal was caught during the read system call. 

RETURN VALUE 

Upon successful completion a non-negative integer is returned indicating the 
number of bytes actually read. Otherwise, a —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

creat (2), dup (2), fcntl (2), ioctl(2), open (2), pipe (2). 

termio(7) in the UNIX System V Administrator Reference Manual. 
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NAME 

semctl — semaphore control operations 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/sein.h> 

int semctl (semid, semnum, cmd, arg) 
int semid, cmd; 
int semnum; 
union semun { 
int val; 

struct semid_ds *buf; 
ushort *array; 

} arg; 
DESCRIPTION 

Semctl provides a variety of semaphore control operations as specified by cmd. 

The following cmds are executed with respect to the semaphore specified by 
semid and semnum: 

GETVAL Return the value of semval (see introil)). {READ} 

SETVAL Set the value of semval to arg.val. {ALTER} When this 
cmd is successfully executed, the semadj value 
corresponding to the specified semaphore in all processes 
is cleared. 

GETPID Return the value of sempid. {READ} 

GETNCNT Return the value of semncnt. {READ} 

GETZCNT Return the value of semzcnt. {READ} 

The following cmds return and set, respectively, every semval in the set of 
semaphores. 

GETALL Place semvals into array pointed to by arg.array. 
{READ} 

SETALL Set semvals according to the array pointed to by 
arg.array. {ALTER} When this cmd is successfully exe- 
cuted the semadj values corresponding to each specified 
semaphore in all processes are cleared. 

The following cmds are also available: 

IPC STAT Place the current value of each member of the data 
structure associated with semid into the structure pointed 
to by arg.buf. The contents of this structure are defined 
in introil). {READ} 

IPC SET Set the value of the following members of the data struc- 
ture associated with semid to the corresponding value 
found in the structure pointed to by arg.buf: 
sem_perm.uid 
semjperm.gid 

sem_perm.mode /* only low 9 bits •/ 

This cmd can only be executed by a process that has an 
effective user ID equal to either that of super-user or to 
the value of semjierm.uid in the data structure associ- 
ated with semid. 
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IPC RMID Remove the semaphore identifier specified by semid from 
the system and destroy the set of semaphores and data 
structure associated with it. This cmd can only be exe- 
cuted by a process that has an effective user ID equal to 
either that of super-user or to the value of sem perm.uid 
in the data structure associated with semid. 

Semctl will fail if one or more of the following are true: 

[EINVAL] Semid is not a valid semaphore identifier. 

[EINVAL] Semnum is less than zero or greater than seni_nsems. 

[EINVAL] Cmd is not a valid command. 

[EACCES] Operation permission is denied to the calling process 

(see introd)). 

[ERANGE] Cmd is SETVAL or SETALL and the value to which 
semval is to be set is greater than the system imposed 
maximum. 

[EPERM] Cmd is equal to IPC_RMID or IPC_SET and the 

effective user ID of the calling process is not equal to 
that of super-user and it is not equal to the value of 
sein_perm.uid in the data structure associated with 
semid. 

[EFAULT] Arg.buf points to an illegal address. 

RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 

GETVAL The value of semval. 

GETPID The value of sempid. 

GETNCNT The value of semncnt. 

GETZCNT The value of semzcnt. 

All others A value of 0. 

Otherwise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

intro(2), semget(2), semop(2). 
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NAME 

semget — get set of semaphores 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sein.h> 

int semget (key, nsems, semflg) 

key t key; 

int nsems, semflg; 

DESCRIPTION 

Semget returns the semaphore identifier associated with key. 

A semaphore identifier and associated data structure and set containing nsems 
semaphores (see introil)) are created for key if one of the following are true: 

Key is equal to IPC_PRIVATE. 

Key does not already have a semaphore identifier associated with it, 
and {semflg & IPC_CREAT) is "true". 

Upon creation, the data structure associated with the new semaphore identifier 
is initialized as follows: 

Sem_perm.cuid, sem_perm.uid, sem_perm.cgid, and sem_perm.gid are set 

equal to the effective user ID and effective group ID, respectively, of 
the calling process. 

The low-order 9 bits of sem_perm.mode are set equal to the low-order 9 
bits of semflg. 

Sem_nsems is set equal to the value of nsems. 

Sem_otime is set equal to 0 and sem_ctime is set equal to the current 
time. 

Semget will fail if one or more of the following are true: 

[EINVAL] Nsems is either less than or equal to zero or greater than the 

system-imposed limit. 

[EACCES] A semaphore identifier exists for key, but operation permis- 

sion (see introil)) as specified by the low -order 9 bits of 
semflg would not be granted. 

[EINVAL] A semaphore identifier exists for key, but the number of 

semaphores in the set associated with it is less than nsems and 
nsems is not equal to zero. 

[ENOENT] A semaphore identifier does not exist for key and {semflg & 
IPC_CREAT) is "false". 

[ENOSPC] A semaphore identifier is to be created but the system- 

imposed limit on the maximum number of allowed semaphore 
identifiers system wide would be exceeded. 

[ENOSPC] A semaphore identifier is to be created but the system- 

imposed limit on the maximum number of allowed semaphores 
system wide would be exceeded. 

[EEXIST] A semaphore identifier exists for key but ( {semflg & 

IPC CREAT) and ( semflg & IPC_EXCL) ) is "true". 
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RETURN VALUE 

Upon successful completion, a non-negative integer, namely a semaphore 
identifier, is returned. Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

intro(2), semctl(2), semop(2). 
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NAME 

semop — semaphore operations 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/sem.h> 

int semop (semid, sops, nsops) 
int semid; 

struct sembuf **sops; 
int nsops; 

DESCRIPTION 

Semop is used to automatically perform an array of semaphore operations on 
the set of semaphores associated with the semaphore identifier specified by 
semid. Sops is a pointer to the array of semaphore-operation structures. 
Nsops is the number of such structures in the array. The contents of each 
structure includes the following members: 

short sem num; /* semaphore number */ 
short sem op; /* semaphore operation */ 
short sem_flg; /* operation flags */ 

Each semaphore operation specified by sem ap is performed on the correspond- 
ing semaphore specified by semid and sem num. 

Sem op specifies one of three semaphore operations as follows: 

If sem op is a negative integer, one of the following will occur: 
(ALTER) 

If semval (see introil)) is greater than or equal to the abso- 
lute value of sem op, the absolute value of sem op is sub- 
tracted from semval. Also, if isem Jig & SEM UNDO) is 
"true", the absolute value of sem op is added to the calling 
process's semadj value (see exit (2)) for the specified sema- 
phore. 

If semval is less than the absolute value of sem op and 
isem Jig & IPC_N0WAIT) is "true", semop will return 
immediately. 

If semval is less than the absolute value of sem op and 
isem Jig & IPC_N0WAIT) is "false", semop will increment 
the semncnt associated with the specified semaphore and 
suspend execution of the calling process until one of the fol- 
lowing conditions occur. 

Semval becomes greater than or equal to the absolute value 
of sem ap. When this occurs, the value of semncnt associ- 
ated with the specified semaphore is decremented, the abso- 
lute value of semjop is subtracted from semval and, if 
{sem Jig & SEM_UNDO) is "true", the absolute value of 
sem op is added to the calling process's semadj value for the 
specified semaphore. 

The semid for which the calling process is awaiting action is 
removed from the system (see semctliD) . When this occurs, 
errno is set equal to EIDRM, and a value of —1 is returned. 
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The calling process receives a signal that is to be caught. 
When this occurs, the value of semncnt associated with the 
specified semaphore is decremented, and the calling process 
resumes execution in the manner prescribed in signal (2) . 

If sem op is a positive integer, the value of sem_op is added to semval 
and, if i.sem Jig & SE1VI_UND0) is "true", the value of sem op is sub- 
tracted from the calling process's semadj value for the specified sema- 
phore. (ALTER) 

If sem op is zero, one of the following will occur: {READ} 

If semval is zero, semop will return immediately. 

If semval is not equal to zero and (sem Jig & IPC NOWAIT) 
is "true", semop will return immediately. 

If semval is not equal to zero and isem Jig & IPC_NOWAIT) 
is "false", semop will increment the semzcnt associated with 
the specified semaphore and suspend execution of the calling 
process until one of the following occurs: 

Semval becomes zero, at which time the value of semzcnt 
associated with the specified semaphore is decremented. 

The semid for which the calling process is awaiting action is 
removed from the system. When this occurs, errno is set 
equal to EIDRM, and a value of —1 is returned. 

The calling process receives a signal that is to be caught. 
When this occurs, the value of semzcnt associated with the 
specified semaphore is decremented, and the calling process 
resumes execution in the manner prescribed in signal (2) . 

Semop will fail if one or more of the following are true for any of the sema- 
phore operations specified by sops: 

[EINVAL] Semid is not a valid semaphore identifier. 

[EFBIG] Sem num is less than zero or greater than or equal to the 

number of semaphores in the set associated with semid. 

[E2BIG] Nsops is greater than the system-imposed maximum. 

[EACCES] Operation permission is denied to the calling process (see 

intra (2)). 

[EAGAIN] The operation would result in suspension of the calling process 

but (sem Jig & IPC_NOWAIT) is "true". 

[ENOSPC] The limit on the number of individual processes requesting an 

SEM_UNDO would be exceeded. 

[EINVAL] The number of individual semaphores for which the calling 

process requests a SEM_UNDO would exceed the limit. 

[ERANGE] An operation would cause a semval to overflow the system- 
imposed limit. 

[ERANGE] An operation would cause a semadj value to overflow the 
system-imposed limit. 

[EFAULT] Sops points to an illegal address. 

Upon successful completion, the value of sempid for each semaphore specified 
in the array pointed to by sops is set equal to the process ID of the calling pro- 
cess. 
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RETURN VALUE 

If semop returns due to the receipt of a signal, a value of — 1 is returned to the 
calling process and errno is set to EINTR. If it returns due to the removal of a 
semid from the system, a value of —1 is returned and errno is set to EIDRM. 

Upon successful completion, the value of semval at the time of the call for the 
last operation in the array pointed to by sops is returned. Otherwise, a value of 
— 1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), intro(2), semctl(2), semget(2). 
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NAME 

setpgrp — set process group ID 

SYNOPSIS 

int setpgrp () 

DESCRIPTION 

Setpgrp sets the process group ID of the calling process to the process ID of the 
calling process and returns the new process group ID. 

RETURN VALUE 

Setpgrp returns the value of the new process group ID. 

SEE ALSO 

exec (2), fork (2), getpid(2), intro(2), kill(2), signal(2). 
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NAME 

setuid, setgid — set user and group IDs 

SYNOPSIS 

int setuid (uid) 
int uid; 

int setgid (gid) 
int gid; 

DESCRIPTION 

Setuid {setgid) is used to set the real user (group) ID and effective user 
(group) ID of the calling process. 

If the effective user ID of the calling process is super-user, the real user (group) 
ID and effective user (group) ID are set to uid (gid). 

If the effective user ID of the calling process is not super-user, but its real user 
(group) ID is equal to uid (gid), the effective user (group) ID is set to uid 
(gid). 

If the effective user ID of the calling process is not super-user, but the saved 
set-user (group) ID from exec(2) is equal to uid (gid), the effective user 
(group) ID is set to uid (gid). 

Setuid (setgid) will fail if the real user (group) ID of the calling process is not 
equal to uid (gid) and its effective user ID is not super-user. [EPERM] 

The uid is out of range. [EINVAL] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

getuid(2), intro(2). 
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NAME 

shmctl — shared memory control operations 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 

int shmctl (shmid, cmd, buf) 
int shmid, cmd; 
struct shmid ds 'buf; 

DESCRIPTION 

Shmctl provides a variety of shared memory control operations as specified by 
cmd. The following cmds are available: 

IPC STAT Place the current value of each member of the data 
structure associated with shmid into the structure 
pointed to by buf. The contents of this structure are 
defined in intro (2) . {READ} 

IPC SET Set the value of the following members of the data struc- 
ture associated with shmid to the corresponding value 
found in the structure pointed to by buf: 
shmjjerm.uid 
shm_perm.gid 

shmjperm.mode /* only low 9 bits */ 

This cmd can only be executed by a process that has an 
effective user ID equal to either that of super-user or to 
the value of shmjperm.uid in the data structure associ- 
ated with shmid. 

IPC RMID Remove the shared memory identifier specified by shmid 
from the system and destroy the shared memory segment 
and data structure associated with it. This cmd can only 
be executed by a process that has an effective user ID 
equal to either that of super-user or to the value of 
shm_perm.uid in the data structure associated with 
shmid. 

Shmctl will fail if one or more of the following are true: 
[EINVAL] Shmid is not a valid shared memory identifier. 

[EINVAL] Cmd is not a valid command. 

[EACCES] Cmd is equal to IPC_STAT and {READ} operation 

permission is denied to the calling process (see 
int roil)). 

[EPERM] Cmd is equal to IPC_RMID or IPC_SET and the 

effective user ID of the calling process is not equal to 
that of super-user and it is not equal to the value of 
shinj>erm.uid in the data structure associated with 
shmid. 

[EFAULT] Buf points to an illegal address. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

intro (2), shmget(2), shmop(2). 
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NAME 

shmget — get shared memory segment 

SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/shm.h> 

int shmget (key, size, shmflg) 

keyt key; 

int size, shmflg; 

DESCRIPTION 

Shmget returns the shared memory identifier associated with key. 

A shared memory identifier and associated data structure and shared memory 
segment of size size bytes (see int roil)) are created for key if one of the fol- 
lowing are true: 

Key is equal to IPC_PRIVATE. 

Key does not already have a shared memory identifier associated with 
it, and (shmflg & IPC_CREAT) is "true". 

Upon creation, the data structure associated with the new shared memory 
identifier is initialized as follows: 

Shm_perm.cuid, shm_perm.uid, shm_perm.cgid, and shm_perm.gid are 

set equal to the eff"ective user ID and effective group ID, respectively, of 
the calling process. 

The low-order 9 bits of shm_perm.mode are set equal to the low-order 9 
bits of shmflg. Shm_segsz is set equal to the value of size. 

Shm lpid, shm nattch, shm_atime, and shm dtime are set equal to 0. 

Shm_ctime is set equal to the current time. 

Shmget will fail if one or more of the following are true: 

[EINVAL] Size is less than the system-imposed minimum or greater than 

the system-imposed maximum. 

[EACCES] A shared memory identifier exists for key but operation per- 

mission (see introil)) as specified by the low-order 9 bits of 
shmflg would not be granted. 

[EINVAL] A shared memory identifier exists for key but the size of the 

segment associated with it is less than size and size is not 
equal to zero. 

[ENOENT] A shared memory identifier does not exist for key and (.shmflg 
& IPC_CREAT) is "false". 

[ENOSPC] A shared memory identifier is to be created but the system- 

imposed limit on the maximum number of allowed shared 
memory identifiers system wide would be exceeded. 

[ENOMEM] A shared memory identifier and associated shared memory 
segment are to be created but the amount of available physi- 
cal memory is not sufficient to fill the request. 

[EEXIST] a shared memory identifier exists for key but ( (shmflg & 

IPC_CREAT) and ( shmflg & IPC_EXCL) ) is "true". 
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RETURN VALUE 

Upon successful completion, a non-negative integer, namely a shared memory 
identifier is returned. Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

intro(2), shmctl(2), shmop(2). 
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NAME 

shmop — shared memory operations 

SYNOPSIS 

#inciude <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shin.h> 

char •shmat (shmid, shmaddr, shmflg) 
int shmid; 
char *shmaddr 
int shmflg; 

int shmdt (shmaddr) 
char *shmaddr 

DESCRIPTION 

Shmat attaches the shared memory segment associated with the shared 
memory identifier specified by shmid to the data segment of the calling process. 
The segment is attached at the address specified by one of the following cri- 
teria: 

If shmaddr is equal to zero, the segment is attached at the first avail- 
able address as selected by the system. 

If shmaddr is not equal to zero and (shmflg & SHM RND) is "true", 
the segment is attached at the address given by (shmaddr - (shmaddr 
modulus SHMLBA)). 

If shmaddr is not equal to zero and (shmflg & SHM RND) is "false", 
the segment is attached at the address given by shmaddr. 

The segment is attached for reading if (shmflg & SHM_RDONLY) is "true" 
{READ}, otherwise it is attached for reading and writing {READ/WRITE}. 

Shmat will fail and not attach the shared memory segment if one or more of 
the following are true: 

[EINVAL] Shmid is not a valid shared memory identifier. 

[EACCES] Operation permission is denied to the calling process (see 

intro(2)). 

[ENOMEM] The available data space is not large enough to accommodate 
the shared memory segment. 

[EINVAL] Shmaddr is not equal to zero, and the value of (shmaddr - 

(shmaddr modulus SHMLBA)) is an illegal address. 

[EINVAL] Shmaddr is not equal to zero, (shmflg & SHM_RND) is 

"false", and the value of shmaddr is an illegal address. 

[EMFILE] The number of shared memory segments attached to the cal- 

ling process would exceed the system-imposed limit. 

[EINVAL] Shmdt detaches from the calling process's data segment the 

shared memory segment located at the address specified by 
shmaddr. 

[EINVAL] Shmdt will fail and not detach the shared memory segment if 

shmaddr is not the data segment start address of a shared 
memory segment. 
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RETURN VALUES 

Upon successful completion, the return value is as follows: 

Shmat returns the data segment start address of the attached shared 
memory segment. 

Shmdt returns a value of 0. 

Otherwise, a value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), intro(2), shmctl(2), shmget(2). 
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NAME 

signal — specify what to do upon receipt of a signal 

SYNOPSIS 

#include <signal.h> 

int («signal (sig, func))() 
int sig; 

void (*func)(); 
DESCRIPTION 

Signal allows the calling process to choose one of three ways in which it is pos- 
sible to handle the receipt of a specific signal. Sig specifies the signal and func 
specifies the choice. 

Sig can be assigned any one of the following except SIGKILL: 



SIGHUP 


01 


hangup 


SIGINT 


02 


interrupt 


SIGQUIT 


03* 


quit 


SIGILL 


04* 


illegal instruction (not reset when caught) 


SIGTRAP 


05* 


trace trap (not reset when caught) 


SIGIOT 


06* 


lOT instruction 


SIGEMT 


07* 


EMT instruction 


SIGFPE 


08* 


floating point exception 


SIGKILL 


09 


kill (cannot be caught or ignored) 


SIGBUS 


10* 


bus error 


SIGSEGV 


11* 


segmentation violation 


SIGSYS 


12* 


bad argument to system call 


SIGPIPE 


13 


write on a pipe with no one to read it 


SIGALRM 


14 


alarm clock 


SIGTERM 


15 


software termination signal 


SIGUSRl 


16 


user-defined signal 1 


SIGUSR2 


17 


user-defined signal 2 


SIGCLD 


18 


death of a child 






(see WARNING below) 


SIGPWR 


19 


power fail 



(see WARNING below) 



See below for the significance of the asterisk (•) in the above list. 

Func is assigned one of three values: SIG_DFL, SIG IGN, or a function address. 
The actions prescribed by these values are as follows: 

SIG DFL — terminate process upon receipt of a signal 

Upon receipt of the signal sig, the receiving process is to be ter- 
minated with all of the consequences outlined in exit (2). In addi- 
tion a "core image" will be made in the current working directory 
of the receiving process if sig is one for which an asterisk appears in 
the above list and the following conditions are met: 

The effective user ID and the real user ID of the receiving 
process are equal. 

An ordinary file named core exists and is writable or can 
be created. If the file must be created, it will have the fol- 
lowing properties: 

a mode of 0666 modified by the file creation 
mask (see umaskil)) 

a file owner ID that is the same as the effective 
user ID of the receiving process. 
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a file group ID that is the same as the effective 
group ID of the receiving process 

SIGJGN — ignore signal 

The signal sig is to be ignored. 

Note: the signal SIGKILL cannot be ignored. 

function address — catch signal 

Upon receipt of the signal sig, the receiving process is to execute the 
signal-catching function pointed to by func. The signal number sig 
will be passed as the only argument to the signal-catching function. 
Additional arguments are passed to the signal-catching function for 
hardware-generated signals. Before entering the signal-catching func- 
tion, the value of func for the caught signal will be set to SIG DFL 
unless the signal is SIGILL, SIGTRAP, or SIGPWR. 

Upon return from the signal-catching function, the receiving process 
will resume execution at the point it was interrupted. 

When a signal that is to be caught occurs during a read, a write, an 
open, or an ioctl system call on a slow device (like a terminal; but not 
a file), during a pause system call, or during a wait system call that 
does not return immediately due to the existence of a previously 
stopped or zombie process, the signal catching function will be exe- 
cuted and then the interrupted system call may return a —1 to the 
calling process with errno set to EINTR. 

Note: The signal SIGKILL cannot be caught. 

A call to signal cancels a pending signal sig except for a pending SIGKILL sig- 
nal. 

Signal will fail if sig is an illegal signal number, including SIGKILL. [EINVAL] 
RETURN VALUE 

Upon successful completion, signal returns the previous value of func for the 
specified signal sig. Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

k;ill(2), pause(2), ptrace(2), wait(2), setjmp(3C). 
kill(l) in the UNIX System V User Reference Manual. 

WARNING 

Two other signals that behave differently than the signals described above exist 
in this release of the system; they are: 

SIGCLD 1 8 death of a child (reset when caught) 
SIGPWR 19 power fail (not reset when caught) 

There is no guarantee that, in future releases of the UNIX system, these signals 
will continue to behave as described below; they are included only for compati- 
bility with other versions of the UNIX system. Their use in new programs is 
strongly discouraged. 

For these signals, func is assigned one of three values: SIG_DFL, SIGJGN, or a 
function address. The actions prescribed by these values of are as follows: 

SIG DFL - ignore signal 

The signal is to be ignored. 

SIG IGN - ignore signal 

The signal is to be ignored. Also, if sig is SIGCLD, the calling 
process's child processes will not create zombie processes when they 
terminate; see exit (2) . 
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function address - catch signal 

If the signal is SIGPWR, the action to be taken is the same as that 
described above for func equal to function address. The same is 
true if the signal is SIGCLD except, that while the process is execut- 
ing the signal-catching function, any received SIGCLD signals will 
be queued and the signal-catching function will be continually reen- 
tered until the queue is empty. 

The SIGCLD affects two other system calls {wait (2), and exitil)) in the fol- 
lowing ways: 

wait If the func value of SIGCLD is set to SIGJGN and a wait is exe- 
cuted, the wait will block until all of the calling process's child 
processes terminate; it will then return a value of — 1 with errno set 
to ECHILD. 

exit If in the exiting process's parent process the func value of SIGCLD is 
set to SIGJGN, the exiting process will not create a zombie process. 

When processing a pipeline, the shell makes the last process in the pipeline 
the parent of the proceeding processes. A process that may be piped into in 
this manner (and thus become the parent of other processes) should take 
care not to set SIGCLD to be caught. 
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NAME 

Stat, fstat — get file status 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/stat.h> 

int Stat (path, buf) 
char «path; 
struct Stat *buf; 

int fstat (tildes, buf) 
int tildes; 
struct Stat ♦buf; 

DESCRIPTION 

Path points to a path name naming a file. Read, write, or execute permission 
of the named file is not required, but all directories listed in the path name 
leading to the file must be searchable. Stat obtains information about the 
named file. 

Similarly, fstat obtains information about an open file known by the file 
descriptor fildes, obtained from a successful open, creat, dup, fcntl, or pipe 
system call. 

Buf is a pointer to a stat structure into which information is placed concerning 
the file. 

The contents of the structure pointed to by buf include the following members: 
ushort st mode; /* File mode; see mknodil) */ 
ino t st ino; /* Inode number */ 

dev t st dev; /* ID of device containing */ 

/* a directory entry for this file •/ 
/* ID of device */ 
/* This entry is defined only for */ 
/* character special or block special files */ 
short st nlink; /* Number of links */ 
ushort st uid; /* User ID of the file's owner */ 

ushort stjgid; /* Group ID of the file's group */ 

off t st size; /* File size in bytes */ 
time t st atime; /* Time of last access */ 
time t st mtime; /* Time of last data modification ♦/ 
time t st ctime; /* Time of last file status change */ 

/♦ Times measured in seconds since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 

st_atime Time when file data was last accessed. Changed by the following 
system calls: creat (2), mknodil), pipe i2), utimeil), and read (2). 

st_nitime Time when data was last modified. Changed by the following sys- 
tem calls: creat (2), mknodi2) , pipei2) , utime{2), and write{2). 

st_ctime Time when file status was last changed. Changed by the following 
system calls: chmodi.2), chowni.2), creat (2), link (2), mknod{2), 
pipe {2), unlink (2), utime(2), and write (2). 

Stat will fail if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path 

prefix. 



dev t St rdev; 
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[EFAULT] Buf or path points to an invalid address. 

Fstat will fail if one or more of the following are true: 
[EBADF] Fildes is not a valid open file descriptor. 

[EFAULT] Buf points to an invalid address. 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

chmod(2), chown(2), creat(2), link(2), mlcnod(2), pipe(2), read(2), time(2), 
unlink(2), utime(2), write(2). 
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NAME 

stime — set time 

SYNOPSIS 

int stime (tp) 
long «tp; 

DESCRIPTION 

Stime sets the system's idea of the time and date. Tp points to the value of 
time as measured in seconds from 00:00:00 GMT January 1, 1970. 

[EPERM] Stime will fail if the effective user ID of the calling process is 

not super-user. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

time (2). 
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NAME 

sync — update super-block 

SYNOPSIS 

void sync ( ) 

DESCRIPTION 

Sync causes all information in memory that should be on disk to be written out. 
This includes modified super blocks, modified i-nodes, and delayed block I/O. 

It should be used by programs which examine a file system, for example fsck, 
df, etc. It is mandatory before a boot. 

The writing, although scheduled, is not necessarily complete upon return from 
sync. 
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NAME 

time — get time 

SYNOPSIS 

long time ((long •) 0) 

long time (tloc) 
long •tloc; 

DESCRIPTION 

Time returns the value of time in seconds since 00:00:00 GMT, January 1, 
1970. 

If tloc (taken as an integer) is non-zero, the return value is also stored in the 
location to which tloc points. 

[EFAULT] Time will fail if tloc points to an illegal address. 
RETURN VALUE 

Upon successful completion, time returns the value of time. Otherwise, a value 
of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

stime(2). 



I 
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NAME 

times — get process and child process times 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/times.h> 

long times (buffer) 
struct tms *buffer; 

DESCRIPTION 

Times fills the structure pointed to by buffer with time-accounting information. 
The following are the contents of this structure: 

struct tms { 

timet tmsutime; 
timet tmsstime; 
timet tmscutime; 
timet tmscstime; 

}; 

This information comes from the calling process and each of its terminated 
child processes for which it has executed a wait. All times are in 60ths of a 
second on DEC processors, lOOths of a second on AT&T processors. 

Tms utime is the CPU time used while executing instructions in the user space 
of the calling process. 

Tms stime is the CPU time used by the system on behalf of the calling process. 

Tms cutime is the sum of the tms utimes and tms cutimes of the child 
processes. 

Tms cstime is the sum of the tms stimes and tms_cstimes of the child 
processes. 

[EFAULT] Times will fail if buffer points to an illegal address. 
RETURN VALUE 

Upon successful completion, times returns the elapsed real time, in 60ths 
(lOOths) of a second, since an arbitrary point in the past (e.g., system start-up 
time). This point does not change from one invocation of times to another. If 
times fails, a —1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec (2), fork (2), time (2), wait (2). 
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NAME 

ulimit — get and set user limits 

SYNOPSIS 

long ulimit (cmd, newlimit) 
int cmd; 
long newlimit; 

DESCRIPTION 

This function provides for control over process limits. The cmd values available 
are: 

1 Get the file size Hmit of the process. The limit is in units of 512-byte 
blocks and is inherited by child processes. Files of any size can be read. 

2 Set the file size limit of the process to the value of newlimit. Any process 
may decrease this limit, but only a process with an effective user ID of 
super-user may increase the limit. Ulimit will fail and the limit will be 
unchanged if a process with an effective user ID other than super-user 
attempts to increase its file size limit. [EPERM] 

3 Get the maximum possible break value. See brk (2) . 
RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 

SEE ALSO 

brk (2), write (2). 
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NAME 

umask — set and get file creation mask 

SYNOPSIS 

int umask (cmask) 
int cmask; 

DESCRIPTION 

Umask sets the process's file mode creation mask to cmask and returns the pre- 
vious value of the mask. Only the low-order 9 bits of cmask and the file mode 
creation mask are used. 

RETURN VALUE 

The previous value of the file mode creation mask is returned. 

SEE ALSO 

chmod(2), creat(2), mknod(2), open (2). 

mkdir(l), sh(l) in the UNIX System V User Reference Manual. 
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NAME 

umount — unmount a file system 

SYNOPSIS 

int umount (spec) 
char 'spec; 

DESCRIPTION 

Umount requests that a previously mounted file system contained on the block 
special device identified by spec be unmounted. Spec is a pointer to a path 
name. After unmounting the file system, the directory upon which the file sys- 
tem was mounted reverts to its ordinary interpretation. 

Umount may be invoked only by the super-user. 

Umount will fail if one or more of the following are true: 

[EPERM] The process's effective user ID is not super-user. 

[ENXIO] Spec does not exist. 

[ENOTBLK] Spec is not a block special device. 

[EINVAL] Spec is not mounted. 

[EBUSY] A file on spec is busy. 

[EFAULT] Spec points to an illegal address. 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of — 1 
is returned and errno is set to indicate the error. 

SEE ALSO 

mount (2). 
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NAME 

uname — get name of current UNIX system 

SYNOPSIS 

#include <sys/utsname.h> 

int uname (name) 
struct utsname *name; 

DESCRIPTION 

Uname stores information identifying the current UNIX system in the structure 
pointed to by name. 

Uname uses the structure defined in <sys/utsname.h> whose members are: 

char sysname[9]; 

char nodename[9]; 

char release[9]; 

char version[9]; 

char machine[9]; 

Uname returns a null-terminated character string naming the current UNIX 
system in the character array sysname. Similarly, nodename contains the 
name that the system is known by on a communications network. Release and 
version further identify the operating system. Machine contains a standard 
name that identifies the hardware that the UNIX system is running on. 

[EFAULT] Uname will fail if name points to an invalid address. 

RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise, —1 is 
returned and errno is set to indicate the error. 

SEE ALSO 

uname(l) in the UNIX System V User Reference Manual. 
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NAME 

unlink — remove directory entry 

SYNOPSIS 

int unlink (path) 
char 'path; 

DESCRIPTION 

Unlink removes the directory entry named by the path name pointed to be 
path. 

The named file is unlinked unless one or more of the following are true: 
[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path 

prefix. 

[EACCES] Write permission is denied on the directory containing the link 

to be removed. 

[EPERM] The named file is a directory and the effective user ID of the 

process is not super-user. 

[EBUSY] The entry to be unlinked is the mount point for a mounted file 

system. 

[ETXTBSY] The entry to be unlinked is the last link to a pure procedure 
(shared text) file that is being executed. 

tEROFS] The directory entry to be unlinked is part of a read-only file 

system. 

[EFAULT] Path points outside the process's allocated address space. 

When all links to a file have been removed and no process has the file open, the 
space occupied by the file is freed and the file ceases to exist. If one or more 
processes have the file open when the last link is removed, the removal is post- 
poned until all references to the file have been closed. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

close (2), link (2), open (2). 

rm(l) in the UNIX System V User Reference Manual. 
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NAME 

ustat — get file system statistics 

SYNOPSIS 

#include <sys/types.h> 
#include <u$tat.h> 



int ustat (dev, buf) 
int dev; 

struct ustat 'buf; 
DESCRIPTION 

Ustat returns information about a mounted file system. Dev is a device number 
identifying a device containing a mounted file system. Buf is a pointer to a 
ustat structure that includes to following elements: 

daddr t f_tfree; /* Total free blocks */ 

ino t f_tinode; /* Number of free inodes •/ 

char f_fname[6]; /♦ Filsys name */ 

char f_fpack[6]; /* Filsys pack name */ 

Ustat will fail if one or more of the following are true: 

[EINVAL] Dev is not the device number of a device containing a 

mounted file system. 

[EFAULT] Buf points outside the process's allocated address space. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

Stat (2), fs(4). 
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NAME 

utime — set file access and modification times 

SYNOPSIS 

#include <sys/types.h> 
int utime (path, times) 
char 'path; 
struct utimbuf 'times; 

DESCRIPTION 

Path points to a path name naming a file. Utime sets the access and 
modification times of the named file. 

If times is NULL, the access and modification times of the file are set to the 
current time. A process must be the owner of the file or have write permission 
to use utime in this manner. 

If times is not NULL, times is interpreted as a pointer to a utimbuf structure 
and the access and modification times are set to the values contained in the 
designated structure. Only the owner of the file or the super-user may use 
utime this way. 

The times in the following structure are measured in seconds since 00:00:00 
GMT, Jan. 1, 1970. 

struct utimbuf { 

time t actime; /* access time */ 
time t modtime; /* modification time */ 

}; 

Utime will fail if one or more of the following are true: 

[ENOENT] The named file does not exist. 

[ENOTDIR] A component of the path prefix is not a directory. 

[EACCES] Search permission is denied by a component of the path 

prefix. 

[EPERM] The effective user ID is not super-user and not the owner of 

the file and times is not NULL. 

[EACCES] The effective user ID is not super-user and not the owner of 

the file and times is NULL and write access is denied. 

[EROFS] The file system containing the file is mounted read-only. 

[EFAULT] Times is not NULL and points outside the process's allocated 

address space. 

[EFAULT] Path points outside the process's allocated address space. 

RETURN VALUE 

Upon successful conipletion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 

SEE ALSO 

Stat (2). 
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NAME 

wait — wait for child process to stop or terminate 

SYNOPSIS 

int wait (statjoc) 
int ♦stat_loc; 

int wait ((int •)0) 

DESCRIPTION 

Wait suspends the calling process until until one of the immediate children ter- 
minates or until a child that is being traced stops, because it has hit a break 
point. The wait system call will return prematurely if a signal is received and 
if a child process stopped or terminated prior to the call on wait, return is 
immediate. 

If statjoc (taken as an integer) is non-zero, 16 bits of information called 
status are stored in the low order 16 bits of the location pointed to by statjoc. 
Status can be used to differentiate between stopped and terminated child 
processes and if the child process terminated, status identifies the cause of ter- 
mination and passes useful information to the parent. This is accomplished in 
the following manner: 

If the child process stopped, the high order 8 bits of status will contain 
the number of the signal that caused the process to stop and the low 
order 8 bits will be set equal to 0177. 

If the child process terminated due to an exit call, the low order 8 bits 
of status will be zero and the high order 8 bits will contain the low 
order 8 bits of the argument that the child process passed to exit; see 
exit (2) . 

If the child process terminated due to a signal, the high order 8 bits of 
status will be zero and the low order 8 bits will contain the number of 
the signal that caused the termination. In addition, if the low order 
seventh bit (i.e., bit 200) is set, a "core image" will have been pro- 
duced; see signal (2) . 

If a parent process terminates without waiting for its child processes to ter- 
minate, the parent process ID of each child process is set to 1. This means the 
initialization process inherits the child processes; see introil). 

Wait will fail and return immediately if one or more of the following are true: 

[ECHILDl The calling process has no existing unwaited-for child 

processes. 

[EFAULT] Stat joc points to an illegal address. 

RETURN VALUE 

If wait returns due to the receipt of a signal, a value of —1 is returned to the 
calling process and errno is set to EINTR. If wait returns due to a stopped or 
terminated child process, the process ID of the child is returned to the calling 
process. Otherwise, a value of —1 is returned and errno is set to indicate the 
error. 

SEE ALSO 

exec (2), exit (2), fork (2), intro(2), pause (2), ptrace(2), signal (2). 

WARNING 

See WARNING in signal (2). 
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NAME 

write — write on a file 

SYNOPSIS 

int write (fildes, buf, nbyte) 
int fildes; 
char 'buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup,fcntl, or pipe sys- 
tem call. 

Write attempts to write nbyte bytes from the buffer pointed to by buf to the 
file associated with the fildes. 

On devices capable of seeking, the actual writing of data proceeds from the 
position in the file indicated by the file pointer. Upon return from write, the 
file pointer is incremented by the number of bytes actually written. 

On devices incapable of seeking, writing always takes place starting at the 
current position. The value of a file pointer associated with such a device is 
undefined. 

If the O APPEND flag of the file status flags is set, the file pointer will be set to 
the end of the file prior to each write. 

Write will fail and the file pointer will remain unchanged if one or more of the 
following are true: 

[EBADF] Fildes is not a valid file descriptor open for writing. 

[EPIPE and SIGPIPE signal] 

An attempt is made to write to a pipe that is not open for 
reading by any process. 

[EFBIG] An attempt was made to write a file that exceeds the process's 

file size limit or the maximum file size. See ulimit (2) . 

[EFAULT] Buf points outside the process's allocated address space. 

[EINTR] A signal was caught during the write system call. 

If a write requests that more bytes be written than there is room for (e.g., the 
ulimit (see ulimit (2)) or the physical end of a medium), only as many bytes as 
there is room for will be written. For example, suppose there is space for 20 
bytes more in a file before reaching a limit. A write of 512 bytes will return 
20. The next write of a non-zero number of bytes will give a failure return 
(except as noted below). 

If the file being written is a pipe (or FIFO) and the 0_NDELAY flag of the file 
flag word is set, then write to a full pipe (or FIFO) will return a count of 0. 
Otherwise (0_NDELAY clear), writes to a full pipe (or FIFO) will block until 
space becomes available. 

RETURN VALUE 

Upon successful completion the number of bytes actually written is returned. 
Otherwise, —1 is returned and errno is set to indicate the error. 

SEE ALSO 

creat (2), dup(2), lseek(2), open (2), pipe (2), ulimit (2). 
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NAME 

intro — introduction to subroutines and libraries 

SYNOPSIS 

#include <stdio.h> 

#include <math.h> 

DESCRIPTION 

This section describes functions found in various libraries, other than those 
functions that directly invoke UNIX system primitives, which are described in 
Section 2 of this volume. Certain major collections are identified by a letter 
after the section number: 

(3C) These functions, together with those of Section 2 and those marked 
(3S), constitute the Standard C Library libc, which is automatically 
loaded by the C compiler, ceil). The link editor Idil) searches this 
library under the — Ic option. Declarations for some of these functions 
may be obtained from #include files indicated on the appropriate pages. 

(3S) These functions constitute the "standard I/O package" (see stdioOS)). 
These functions are in the library libc, already mentioned. Declarations 
for these functions may be obtained from the #include file <stdio.h>. 

(3M) These functions constitute the Math Library, libm. They are automati- 
cally loaded as needed by the FORTRAN compiler /77(1). They are not 
automatically loaded by the C compiler, ceil); however, the link editor 
searches this library under the — Im option. Declarations for these func- 
tions may be obtained from the #include file <math.h>. Several gen- 
erally useful mathematical constants are also defined there (see 
mathiS)). 

(3X) Various specialized libraries. The files in which these libraries are found 
are given on the appropriate pages. 

(3F) These functions constitute the FORTRAN intrinsic function library, 
libF77 . These functions are automatically available to the FORTRAN 
programmer and require no special invocation of the compiler. 

DEFINITIONS 

A character is any bit pattern able to fit into a byte on the machine. The null 
character is a character with value 0, represented in the C language as '\0'. A 
character array is a sequence of characters. A null -terminated character 
array is a sequence of characters, the last of which is the null character. A 
string is a designation for a null-terminated character array. The null string 
is a character array containing only the null character. A NULL pointer is the 
value that is obtained by casting 0 into a pointer. The C language guarantees 
that this value will not match that of any legitimate pointer, so many functions 
that return pointers return it to indicate an error. NULL is defined as 0 in 
<stdio.h>; the user can include an appropriate definition if not using 
<stdio.h>. 

Many groups of FORTRAN intrinsic functions have generic function names that 
do not require explicit or implicit type declaration. The type of the function 
will be determined by the type of its argument(s). For example, the generic 
function max will return an integer value if given integer arguments imaxO), a 
real value if given real arguments (amaxl), or a double-precision value if given 
double-precision arguments (dmaxl). 

FILES 

/lib/libc.a 

/lib/libm.a 

/usr/nb/libF77.a 
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SEE ALSO 

intro(2), stdioOS), math(5). 

ar(l), cc(l), f77(l), ld(l), lint(l), nm(l) in the UNIX System V User Refer- 
ence Manual. 

DIAGNOSTICS 

Functions in the C and Math Libraries (3C and 3M) may return the conven- 
tional values 0 or ±HUGE (the largest-magnitude single-precision floating-point 
numbers; HUGE is defined in the <math.h> header file) when the function is 
undefined for the given arguments or when the value is not representable. In 
these cases, the external variable errno (see intro{2)) is set to the value EDOM 
or ERANGE. As many of the FORTRAN intrinsic functions use the routines 
found in the Math Library, the same conventions apply. 

WARNING 

Many of the functions in the libraries call and/or refer to other functions and 
external variables described in this section and in section 2 {^System Calls). If 
a program inadvertantly defines a function or external variable with the same 
name, the presumed library version of the function or external variable may not 
be loaded. The Until) program checker reports name conflicts of this kind as 
"multiple declarations" of the names in question. Definitions for sections 2, 3C, 
and 3S are checked automatically. Other definitions can be included by using 
the —I option (for example, — Im includes definitions for the Math Library, sec- 
tion 3M). Use of lint is highly recommended. 
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NAME 

a64l, 164a — convert between long integer and base-64 ASCII string 

SYNOPSIS 

long a641 (s) 
char ♦s; 

char •164a (I) 
long 1; 

DESCRIPTION 

These functions are used to maintain numbers stored in base-64 ASCII charac- 
ters. This is a notation by which long integers can be represented by up to six 
characters; each character represents a "digit" in a radix-64 notation. 

The characters used to represent "digits" are . for 0, / for 1, 0 through 9 for 
2-11, A through Z for 12-37, and a through z for 38-63. 

A641 takes a pointer to a null-terminated base-64 representation and returns a 
corresponding long value. If the string pointed to by J contains more than six 
characters, a64l will use the first six. 

L64a takes a long argument and returns a pointer to the corresponding base-64 
representation. If the argument is 0, I64a returns a pointer to a null string. 

BUGS 

The value returned by I64a is a pointer into a static buffer, the contents of 
which are overwritten by each call. 
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NAME 

abort — generate an lOT fault 

SYNOPSIS 

int abort ( ) 

DESCRIPTION 

Abort first closes all open files if possible, then causes an lOT signal to be sent 
to the process. This usually results in termination with a core dump. 

It is possible for abort to return control if SIGIOT is caught or ignored, in which 
case the value returned is that of the killil) system call. 

SEE ALSO 

exit (2), kill(2), signal (2). 

adb(l), sdb(l) in the UNIX System V User Reference Manual. 
DIAGNOSTICS 

If SIGIOT is neither caught nor ignored, and the current directory is writable, a 
core dump is produced and the message "abort — core dumped" is written by 
the shell. 
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NAME 

abs — return integer absolute value 

SYNOPSIS 

int abs (i) 
int i; 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

BUGS 

In two's-complement representation, the absolute value of the negative integer 
with largest magnitude is undefined. Some implementations trap this error, but 
others simply ignore it. 

SEE ALSO 

floor (3M). 
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NAME 

bsearch — binary search a sorted table 

SYNOPSIS 

#include <search.h> 

char 'bsearch ((char •) key, (char *) base, nel, sizeof (•key), compar) 

unsigned nel; 

int (*conipar)( ); 

DESCRIPTION 

Bsearch is a binary search routine generalized from Knuth (6.2.1) Algorithm 
B. It returns a pointer into a table indicating where a datum may be found. 
The table must be previously sorted in increasing order according to a provided 
comparison function. Key points to a datum instance to be sought in the table. 
Base points to the element at the base of the table. Nel is the number of ele- 
ments in the table. Compar is the name of the comparison function, which is 
called with two arguments that point to the elements being compared. The 
function must return an integer less than, equal to, or greater than zero as 
accordingly the first argument is to be considered less than, equal to, or greater 
than the second. 

EXAMPLE 

The example below searches a table containing pointers to nodes consisting of a 
string and its length. The table is ordered alphabetically on the string in the 
node pointed to by each entry. 

This code fragment reads in strings and either finds the corresponding node and 
prints out the string and its length, or prints an error message. 

#include <stdio.h> 
#include < search. h> 

#define TABSIZE 1000 

struct node { 

char *string; 
int length; 

}; 

struct node table[TABSIZE]; 



{ 

struct node *node_ptr, node; 

int node_compare( ); /* routine to compare 2 nodes */ 
char str_space[20]; /* space to read string into ♦/ 



node.string = strspace; 

while (scanf("%s", node.string) != EOF) { 

node_ptr = (struct node *) bsearch ((char *)(&node), 
(char *) table, TABSIZE, 
sizeof (struct node), nodejcompare) ; 
if (nodejptr != NULL) { 

(void) printf ("string = %20s, length = %d\n", 
node j3tr— > string, node_ptr— > length) ; 

} else { 

(void)printf("not found: %s\n", node.string); 



/♦ these are stored in the table */ 



/* table to be searched */ 
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} 

} 

} 

/* 

This routine compares two nodes based on an 
alphabetical ordering of the string field. 

•/ 

int 

node compare (node 1 , node2) 
struct node *nodel, ♦node2; 
{ 

return strcmp (node l—> string, node2—> string); 

NOTES 

The pointers to the key and the element at the base of the table should be of 
type pointer-to-element, and cast to type pointer-to-character. 
The comparison function need not compare every byte, so arbitrary data may 
be contained in the elements in addition to the values being compared. 
Although declared as type pointer-to-character, the value returned should be 
cast into type pointer-to-element. 

SEE ALSO 

hsearch(3C), lsearch(3C), qsort(3C), tsearch(3C). 
DIAGNOSTICS 

A NULL pointer is returned if the key cannot be found in the table. 
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NAME 

clock — report CPU time used 

SYNOPSIS 

long clock ( ) 

DESCRIPTION 

Clock returns the amount of CPU time (in microseconds) used since the first 
call to clock. The time reported is the sum of the user and system times of the 
calling process and its terminated child processes for which it has executed 
wait (2) or system (3S) . 

The resolution of the clock is 10 milliseconds on AT&T Technologies 3B com- 
puter processors, 16.667 milliseconds on Digital Equipment Corporation proces- 
sors. 

SEE ALSO 

times (2), wait (2), system (3S). 

BUGS 

The value returned by clock is defined in microseconds for compatibility with 
systems that have CPU clocks with much higher resolution. Because of this, 
the value returned will wrap around after accumulating only 2147 seconds of 
CPU time (about 36 minutes). 
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NAME 

toupper, tolower, _toupper, tolower, toascii — translate characters 

SYNOPSIS 

#include <ctype.h> 

int toupper (c) 
int c; 

int tolower (c) 
int c; 

int _toupper (c) 
int c; 

int _tolower (c) 
int c; 

int toascii (c) 
int c; 

DESCRIPTION 

Toupper and tolower have as domain the range of getc(3S>): the integers from 
— 1 through 255. If the argument of toupper represents a lower-case letter, the 
result is the corresponding upper -case letter. If the argument of tolower 
represents an upper-case letter, the result is the corresponding lower-case letter. 
All other arguments in the domain are returned unchanged. 

The macros toupper and tolower, are macros that accomplish the same thing 
as toupper and tolower but have restricted domains and are faster, toupper 
requires a lower-case letter as its argument; its result is the corresponding 
upper-case letter. The macro tolower requires an upper-case letter as its 
argument; its result is the corresponding lower-case letter. Arguments outside 
the domain cause undefined results. 

Toascii yields its argument with all bits turned off that are not part of a stan- 
dard ASCII character; it is intended for compatibility with other systems. 

SEE ALSO 

ctypeOC), getcOS). 
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NAME 

crypt, setkey, encrypt — generate DES encryption 

SYNOPSIS 

char 'crypt (key, salt) 
char 'key, •salt; 

void setkey (key) 
char 'key; 

void encrypt (block, edflag) 
char 'block; 
Int edflag; 

DESCRIPTION 

Crypt is the password encryption function. It is based on the NBS Data 
Encryption Standard (DES), with variations intended (among other things) to 
frustrate use of hardware implementations of the DES for key search. 

Key is a user's typed password. Salt is a two-character string chosen from the 
set [a-zA-ZO-9./]; this string is used to perturb the DES algorithm in one of 
4096 different ways, after which the password is used as the key to encrypt 
repeatedly a constant string. The returned value points to the encrypted pass- 
word. The first two characters are the salt itself. 

The setkey and encrypt entries provide (rather primitive) access to the actual 
DES algorithm. The argument of setkey is a character array of length 64 con- 
taining only the characters with numerical value 0 and 1. If this string is 
divided into groups of 8, the low-order bit in each group is ignored; this gives a 
56-bit key which is set into the machine. This is the key that will be used with 
the above mentioned algorithm to encrypt or decrypt the string block with the 
function encrypt. 

The argument to the encrypt entry is a character array of length 64 containing 
only the characters with numerical value 0 and 1. The argument array is 
modified in place to a similar array representing the bits of the argument after 
having been subjected to the DES algorithm using the key set by setkey. If 
edflag is zero, the argument is encrypted; if non-zero, it is decrypted. 

SEE ALSO 

getpass(3C), passwd(4). 

login (1), passwd(l) in the UNIX System V User Reference Manual. 

BUGS 

The return value points to static data that are overwritten by each call. 
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NAME 

ctermid — generate file name for terminal 

SYNOPSIS 

#include <stdio.h> 
char •ctermid (s) 
char *s; 

DESCRIPTION 

Ctermid generates the path name of the controlling terminal for the current 
process, and stores it in a string. 

If 5 is a NULL pointer, the string is stored in an internal static area, the con- 
tents of which are overwritten at the next call to ctermid, and the address of 
which is returned. Otherwise, s is assumed to point to a character array of at 
least L_ctermid elements; the path name is placed in this array and the value of 
s is returned. The constant L_ctermid is defined in the <stdio.h> header file. 

NOTES 

The difference between ctermid and ttyname (3C) is that ttyname must be 
handed a file descriptor and returns the actual name of the terminal associated 
with that file descriptor, while ctermid returns a string (/dev/tty) that will 
refer to the terminal if used as a file name. Thus ttyname is useful only if the 
process already has at least one file open to a terminal. 

SEE ALSO 

ttynameOC). 
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NAME 

ctime, localtime, gmtime, asctime, tzset — convert date and time to string 

SYNOPSIS 

#include <time.h> 

char *ctime (clock) 
long 'clock; 

struct tm 'localtime (clock) 
long 'clock; 

struct tm 'gmtime (clock) 
long 'clock; 

char 'asctime (tm) 
struct tm 'tm; 

extern long timezone; 

extern int daylight; 

extern char 'tzname[2]; 

void tzset ( ) 

DESCRIPTION 

Ctime converts a long integer, pointed to by clock, representing the time in 
seconds since 00:00:00 GMT, January 1, 1970, and returns a pointer to a 26- 
character string in the following form. All the fields have constant width. 

Sun Sep 16 01:03:52 1973\n\0 

Localtime and gmtime return pointers to "tm" structures, described below. 
Localtime corrects for the time zone and possible Daylight Savings Time; 
gmtime converts directly to Greenwich Mean Time (GMT), which is the time 
the UNIX system uses. 

Asctime converts a "tm" structure to a 26-character string, as shown in the 
above example, and returns a pointer to the string. 

Declarations of all the functions and externals, and the "tm" structure, are in 
the <time.h> header file. The structure declaration is: 

struct tm { 

int tm sec; 
int tm min; 
int tm_hour; 
int tm mday; 
int tm mon; 
int tm_year; 
int tm_wday; 
int tm_yday; 
int tm isdst; 

}; 

Tmjsdst is non-zero if Daylight Savings Time is in effect. 

The external long variable timezone contains the difference, in seconds, between 
GMT and local standard time (in EST, timezone is 5*60*60); the external vari- 
able daylight is non-zero if and only if the standard U.S.A. Daylight Savings 
Time conversion should be applied. The program knows about the peculiarities 
of this conversion in 1974 and 1975; if necessary, a table for these years can be 
extended. 

If an environment variable named TZ is present, asctime uses the contents of 
the variable to override the default time zone. The value of TZ must be a 



/* seconds (0 - 59) */ 
/* minutes (0 - 59) */ 
/* hours (0 - 23) */ 
/* day of month (1 - 31) */ 

/* month of year (0 - 11) */ 
/* year - 1900 */ 
/* day of week (Sunday = 0) */ 
/* day of year (0 - 365) */ 
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three-letter time zone name, followed by a number representing the difference 
between local time and Greenwich Mean Time in hours, followed by an 
optional three-letter name for a daylight time zone. For example, the setting 
for New Jersey would be EST5EDT. The effects of setting TZ are thus to 
change the values of the external variables timezone and daylight; in addition, 
the time zone names contained in the external variable 

char 'tznamelll = { "EST", "EDT" }; 

are set from the environment variable TZ. The function tzset sets these exter- 
nal variables from TZ; tzset is called by asctime and may also be called expli- 
citly by the user. 

Note that in most installations, TZ is set by default when the user logs on, to a 
value in the local /etc/profile file (see profile {A)). 

SEE ALSO 

time (2), getenv(3C), profile (4), environ (5). 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, 
isgraph, iscntrl, isascii — classify characters 

SYNOPSIS 

#include <ctype.h> 

int isalpha (c) 
int c; 

DESCRIPTION 

These macros classify character-coded integer values by table lookup. Each is 
a predicate returning nonzero for true, zero for false. Isascii is defined on all 
integer values; the rest are defined only where isascii is true and on the single 
non-ASCII value EOF (-1 - see stdio(,7>S)). 



isalpha 


c is a letter. 


isupper 


c is an upper-case letter. 


islower 


c is a lower-case letter. 


isdigit 


c is a digit [0-9]. 


isxdigit 


c is a hexadecimal digit [0-9], [A-F] or [a-f]. 


isalnum 


c is an alphanumeric (letter or digit). 


isspace 


c is a space, tab, carriage return, new-line, vertical tab, or 
form-feed. 


ispunct 


c is a punctuation character (neither control nor 
alphanumeric) . 


isprint 


c is a printing character, code 040 (space) through 0176 
(tilde). 


isgraph 


c is a printing character, like isprint except false for space. 


iscntrl 


c is a delete character (0177) or an ordinary control character 
(less than 040) . 


isascii 


c is an ASCII character, code less than 0200. 



DIAGNOSTICS 

If the argument to any of these macros is not in the domain of the function, the 
result is undefined. 

SEE ALSO 

stdio(3S), ascii(5). 
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NAME 

cuserid — get character login name of the user 

SYNOPSIS 

#include <stdio.h> 

char •cuserid (s) 
char *s; 

DESCRIPTION 

Cuserid generates a character-string representation of the login name that the 
owner of the current process is logged in under. If 5 is a NULL pointer, this 
representation is generated in an internal static area, the address of which is 
returned. Otherwise, s is assumed to point to an array of at least L_cuserid 
characters; the representation is left in this array. The constant L_cuserid is 
defined in the <stdio.h> header file. 

DIAGNOSTICS 

If the login name cannot be found, cuserid returns a NULL pointer; if s is not a 
NULL px)inter, a null character (\0) will be placed at sfOj. 

SEE ALSO 

getloginOC), getpwent(3C). 
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NAME 

dial — establish an out-going terminal line connection 

SYNOPSIS 

#include <dial.h> 

int dial (call) 
CALL call; 

void undial (fd) 
int fd; 

DESGRIPTION 

Dial returns a file-descriptor for a terminal line open for read/write. The argu- 
ment to dial is a CALL structure (defined in the <dial.h> header file). 

When finished with the terminal line, the calling program must invoke undial 
to release the semaphore that has been set during the allocation of the terminal 
device. 

The definition of CALL in the <dial.h> header file is: 
typedef struct { 



struct termio *attr; 


/* pointer to termio attribute struct */ 


int 


baud; 


/* transmission data rate */ 


int 


speed; 


/* 212A modem: low=300, high=1200 */ 


char 


♦line; 


/* device name for out-going line */ 


char 


*telno; 


/* pointer to tel-no digits string */ 


int 


modem; 


/* specify modem control for direct lines */ 


char 


* device; 


/*Will hold the name of the device used 
to make a connection */ 


int 


devjen; 


/* The length of the device used to make 
connection */ 







The CALL element speed is intended only for use with an outgoing dialed call, 
in which case its value should be either 300 or 1 200 to identify the 1 1 3 A 
modem, or the high- or low-speed setting on the 212A modem. Note that the 
11 3A modem or the low -speed setting of the 212A modem will transmit at any 
rate between 0 and 300 bits per second. However, the high-speed setting of the 
212A modem transmits and receivers at 1200 bits per secound only. The CALL 
element baud is for the desired transmission baud rate. For example, one 
might set baud to 110 and speed to 300 (or 1200). However, if speed set to 
1200 baud must be set to high (1200). 

If the desired terminal line is a direct line, a string pointer to its device-name 
should be placed in the line element in the CALL structure. Legal values for 
such terminal device names are kept in the L-devices file. In this case, the 
value of the baud element need not be specified as it will be determined from 
the L-devices file. 

The telno element is for a pointer to a character string representing the tele- 
phone number to be dialed. Such numbers may consist only of symbols 
described on the acuil). The termination symbol will be supplied by the dial 
function, and should not be included in the telno string passed to dial in the 
CALL structure. 

The CALL element modem is used to specify modem control for direct lines. 
This element should be non-zero if modem control is required. The CALL ele- 
ment attr is a pointer to a termio structure, as defined in the termio. h header 
file. A NULL value for this pointer element may be passed to the dial function, 
but if such a structure is included, the elements specified in it will be set for 
the outgoing terminal line before the connection is established. This is often 
important for certain attributes such as parity and baud-rate. 
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The CALL element device is used to hold the device name (cul..) that estab- 
lishes the connection. 

The CALL element devjen is the length of the device name that is copied into 
the array device. 

FILES 

/ usr/lib/ uucp/L-devices 
/usr/spool/ uucp/ LC¥^..tty-device 

SEE ALSO 

uucp (I C) in the UNIX System V User Reference Manual. 
alarm (2), read (2), write (2). 

acu(7), termio(7) in the UNIX System V Administrator Reference Manual. 
DIAGNOSTICS 

On failure, a negative value indicating the reason for the failure will be 
returned. Mnemonics for these negative indices as listed here are defined in the 
<dial.h> header file. 



Including the <dial.h> header file automatically includes the <terinio.h> 
header file. 

The above routine uses <stdio.h>, which causes it to increase the size of pro- 
grams, not otherwise using standard I/O, more than might be expected. 



An alarmil) system call for 3600 seconds is made (and caught) within the 
dial module for the purpose of "touching" the LCK.. file and constitutes the 
device allocation semaphore for the terminal device. Otherwise, uucp (IC) may 
simply delete the LCK.. entry on its 90-minute clean-up rounds. The alarm 
may go off while the user program is in a read (2) or write (2) system call, 
causing an apparent error return. If the user program expects to be around for 
an hour or more, error returns from reads should be checked for 
(errno = = EINTR) , and the read possibly reissued. 



INTRPT 
DHUNG 
NO_ANS 
ILLBD 
APROB 
L PROB 
NO_Ldv 
DV NT A 
DV NT K 
NO BD A 
NO BD K 



■2 

•3 

•4 

•5 

•6 

■7 

■8 

■9 

•10 

■11 



/♦ interrupt occurred ♦/ 

/* dialer hung (no return from write) */ 

/* no answer within 10 seconds */ 

/* illegal baud-rate */ 

/* acu problem (openO failure) */ 

/* line problem (openO failure) */ 

/* can't open LDEVS file */ 

/♦ requested device not available •/ 

/* requested device not known */ 

/* no device available at requested baud */ 

/* no device known at requested baud */ 



WARNINGS 



BUGS 
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NAME 

drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, 
lcong48 — generate uniformly distributed pseudo-random numbers 

SYNOPSIS 

double drand48 ( ) 

double erand48 (xsubi) 
unsigned short xsubiOl; 

long lrand48 ( ) 

long nrand48 (xsubi) 
unsigned short xsubi[3l; 

long mrand48 ( ) 

long jrand48 (xsubi) 
unsigned short xsubiOI; 

void srand48 (seedval) 
long seedval; 

unsigned short *seed48 (seedl6v) 
unsigned short seedl6v[3]; 

void lcong48 (param) 
unsigned short param[7]; 

DESCRIPTION 

This family of functions generates pseudo-random numbers using the well- 
known linear congruential algorithm and 48-bit integer arithmetic. 

Functions drand48 and erand48 return non-negative double-precision floating- 
point values uniformly distributed over the interval [0.0, 1.0). 

Functions lrand48 and nrand48 return non-negative long integers uniformly 
distributed over the interval [0, 2^'). 

Functions mrand48 and jrand48 return signed long integers uniformly distri- 
buted over the interval [-2^\ 2^'). 

Functions srand48, seed48 and lcong48 are initialization entry points, one of 
which should be invoked before either drand48, lrand48 or mrand48 is called. 
(Although it is not recommended practice, constant default initializer values 
will be supplied automatically if drand48, lrand48 or mrand48 is called 
without a prior call to an initialization entry point.) Functions erand48, 
nrand48 and jrand48 do not require an initialization entry point to be called 
first. 

All the routines work by generating a sequence of 48-bit integer values, A", , 
according to the linear congruential formula 

The parameter m = 2'*^; hence 48-bit integer arithmetic is performed. Unless 
lcong48 has been invoked, the multiplier value a and the addend value c are 
given by 

a = 5DEECE66D,6 = 273673163155g 

C = Bi6= 138. 

The value returned by any of the functions drand48, erand48, lrand48, 
nrand48, mrand48 or jrand48 is computed by first generating the next 48 -bit 
Xf in the sequence. Then the appropriate number of bits, according to the type 
of data item to be returned, are copied from the high-order (leftmost) bits of 
Xi and transformed into the returned value. 
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The functions drand48, lrand48 and mrand48 store the last 48-bit A', gen- 
erated in an internal buflFer; that is why they must be initialized prior to being 
invoked. The functions erand48, nrand48 and jrand48 require the calling pro- 
gram to provide storage for the successive Xi values in the array specified as an 
argument when the functions are invoked. That is why these routines do not 
have to be initialized; the calling program merely has to place the desired ini- 
tial value of Xi into the array and pass it as an argument. By using different 
arguments, functions erand48, nrand48 and jrand48 allow separate modules of 
a large program to generate several independent streams of pseudo-random 
numbers, i.e., the sequence of numbers in each stream will not depend upon 
how many times the routines have been called to generate numbers for the 
other streams. 

The initializer function srand48 sets the high-order 32 bits of Xi to the 32 bits 
contained in its argument. The low-order 16 bits of A", are set to the arbitrary 
value 330Ei6. 

The initializer function seed48 sets the value of Xi to the 48-bit value specified 
in the argument array. In addition, the previous value of A", is copied into a 
48-bit internal buffer, used only by seed48, and a pointer to this buffer is the 
value returned by seed48. This returned pointer, which can just be ignored if 
not needed, is useful if a program is to be restarted from a given point at some 
future time — use the pointer to get at and store the last A", value, and then 
use this value to reinitialize via seed48 when the program is restarted. 

The initialization function lcong48 allows the user to specify the initial A", , the 
multiplier value a, and the addend value c. Argument array elements 
param[0-2] specify A,, param[3-5] specify the multiplier a, and paramfSj 
specifies the 16-bit addend c. After lcong48 has been called, a subsequent call 
to either srand48 or seed48 will restore the "standard" multiplier and addend 
values, a and c, specified on the previous page. 

NOTES 

The versions of these routines are coded in portable C. The 
source code for the portable version can even be used on computers which do 
not have floating-point arithmetic. In such a situation, functions drand48 and 
erand48 do not exist; instead, they are replaced by the two new functions 
below. 



long irand48 (m) 
unsigned short m; 

long krand48 (xsubi, m) 
unsigned short xsubi[3], m; 

Functions irand48 and krand48 return non-negative long integers uniformly 
distributed over the interval [0, w — I]. 

SEE ALSO 

rand(3C). 
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NAME 

ecvt, fcvt, gcvt — convert floating-point number to string 

SYNOPSIS 

char «ecvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char 'fcvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char *gcvt (value, ndigit, buf) 
double value; 
int ndigit; 
char 'buf; 

DESCRIPTION 

Ecvt converts value to a null-terminated string of ndigit digits and returns a 
pointer thereto. The high-order digit is non-zero, unless the value is zero. The 
low-order digit is rounded. The position of the decimal point relative to the 
beginning of the string is stored indirectly through decpt (negative means to 
the left of the returned digits). The decimal point is not included in the 
returned string. If the sign of the result is negative, the word pointed to by 
sign is non-zero, otherwise it is zero. 

Fcvt is identical to ecvt, except that the correct digit has been rounded for 
printf "%f ' (FORTRAN F-format) output of the number of digits specified by 
ndigit . 

Gcvt converts the value to a null-terminated string in the array pointed to by 
buf and returns buf. It attempts to produce ndigit significant digits in FOR- 
TRAN F-format if possible, otherwise E-format, ready for printing. A minus 
sign, if there is one, or a decimal point will be included as part of the returned 
string. Trailing zeros are suppressed. 

SEE ALSO 

printf (3S). 

BUGS 

The values returned by ecvt and fcvt point to a single static data array whose 
content is overwritten by each call. 
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NAME 

end, etext, edata — last locations in program 

SYNOPSIS 

extern end; 
extern etext; 
extern edata; 

DESCRIPTION 

These names refer neither to routines nor to locations with interesting contents. 
The address of etext is the first address above the program text, edata above 
the initialized data region, and end above the uninitialized data region. 

When execution begins, the program break (the first location beyond the data) 
coincides with end, but the program break may be reset by the routines of 
brkil), mallocOC), standard input/output istdioi3S)), the profile (— p) 
option of ceil), and so on. Thus, the current value of the program break 
should be determined by sbrk(O) (see brkil)). 

SEE ALSO 

brk(2), mallocOC), stdioOS). 

cc(l) in the UNIX System V User Reference Manual. 
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NAME 

fclose, fflush — close or flush a stream 

SYNOPSIS 

#include <stdio.h> 

int fclose (stream) 
FILE •stream; 

int fflush (stream) 
FILE 'Stream; 

DESCRIPTION 

Fclose causes any buffered data for the named stream to be written out, and 
the stream to be closed. 

Fclose is performed automatically for all open files upon calling exit (2) . 

Fflush causes any buffered data for the named stream to be written to that file. 
The stream remains open. 

DIAGNOSTICS 

These functions return 0 for success, and EOF if any error (such as trying to 
write to a file that has not been opened for writing) was detected. 

SEE ALSO 

close(2), exit(2), fopen(3S), setbufOS). 
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NAME 

ferror, feof, clearerr, fileno — stream status inquiries 

SYNOPSIS 

#include <stdio.h> 

int ferror (stream) 
FILE *streani; 

int feof (stream) 
FILE 'Stream; 

void clearerr (stream) 
FILE *stream; 

int fileno (stream) 
FILE *stream; 

DESCRIPTION 

Ferror returns non-zero when an I/O error has previously occurred reading 
from or writing to the named stream, otherwise zero. 

Feof returns non-zero when EOF has previously been detected reading the 
named input stream, otherwise zero. 

Clearerr resets the error indicator and EOF indicator to zero on the named 
stream. 

Fileno returns the integer file descriptor associated with the named stream; see 
open (2) . 

NOTE 

All these functions are implemented as macros; they cannot be declared or 
redeclared. 

SEE ALSO 

open (2), fopen(3S). 
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NAME 

fopen, freopen, fdopen — open a stream 

SYNOPSIS 

#include <stdio.h> 

FILE *fopen (file-name, type) 
char •file-name, *type; 

FILE *freopen (file-name, type, stream) 
char *file-name, 'type; 
FILE »stream; 

FILE *fdopen (fildes, type) 
int fildes; 
char ♦type; 

DESCRIPTION 

Fopen opens the file named by file-name and associates a stream with it. 
Fopen returns a pointer to the FILE structure associated with the stream. 

File-name points to a character string that contains the name of the file to be 
opened. 

Type is a character string having one of the following values: 



"r" 


open for reading 


"w" 


truncate or create for writing 


"a" 


append; open for writing at end of file, or create for writing 


"r+" 


open for update (reading and writing) 


"w+" 


truncate or create for update 


"a+" 


append; open or create for update at end-of-file 



Freopen substitutes the named file in place of the open stream. The original 
stream is closed, regardless of whether the open ultimately succeeds. Freopen 
returns a pointer to the FILE structure associated with stream. 

Freopen is typically used to attach the preopened streams associated with stdin, 
stdout and stderr to other files. 

Fdopen associates a stream with a file descriptor. File descriptors are obtained 
from open, dup, creat, or pipeil), which open files but do not return pointers 
to a FILE structure stream. Streams are necessary input for many of the Sec- 
tion 3S library routines. The type of stream must agree with the mode of the 
open file. 

When a file is opened for update, both input and output may be done on the 
resulting stream. However, output may not be directly followed by input 
without an intervening fseek or rewind, and input may not be directly followed 
by output without an intervening fseek, rewind, or an input operation which 
encounters end-of-file. 

When a file is opened for append (i.e., when type is "a" or "a-H"), it is impossi- 
ble to overwrite information already in the file. Fseek may be used to reposi- 
tion the file pointer to any position in the file, but when output is written to the 
file, the current file pointer is disregarded. All output is written at the end of 
the file and causes the file pointer to be repositioned at the end of the output. 
If two separate processes open the same file for append, each process may write 
freely to the file without fear of destroying output being written by the other. 
The output from the two processes will be intermixed in the file in the order in 
which it is written. 
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SEE ALSO 

creat(2), dup(2), open (2), pipe (2), fclose(3S), fseek(3S). 

DIAGNOSTICS 

Fopen and freopen return a NULL pointer on failure. 
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NAME 

fread, fwrite — binary input/output 

SYNOPSIS 

#include <stdio.h> 

int fread (ptr, size, nitems, stream) 

char 'ptr; 

int size, nitems; 

FILE *stream; 

int fwrite (ptr, size, nitems, stream) 

char ♦ptr; 

int size, nitems; 

FILE *stream; 

DESCRIPTION 

Fread copies, into an array pointed to by ptr, nitems items of data from the 
named input stream, where an item of data is a sequence of bytes (not neces- 
sarily terminated by a null byte) of length size. Fread stops appending bytes if 
an end-of-file or error condition is encountered while reading stream, or if 
nitems items have been read. Fread leaves the file pointer in stream, if 
defined, pointing to the byte following the last byte read if there is one. Fread 
does not change the contents of stream. 

Fwrite appends at most nitems items of data from the array pointed to by ptr 
to the named output stream. Fwrite stops appending when it has appended 
nitems items of data or if an error condition is encountered on stream. Fwrite 
does not change the contents of the array pointed to by ptr. 

The argument size is typically sizeof(*ptr) where the pseudo-function sizeof 
specifies the length of an item pointed to by ptr. If ptr points to a data type 
other than char it should be cast into a pointer to char. 

SEE ALSO 

read (2), write (2), fopen(3S), getcOS), getsOS), printfOS), putc(3S), 
putsOS), scanfOS). 

DIAGNOSTICS 

Fread and fwrite return the number of items read or written. If size or nitems 
is non-positive, no characters are read or written and 0 is returned by both 
fread and fwrite. 
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NAME 

frexp, Idexp, modf — manipulate parts of floating-point numbers 

SYNOPSIS 

double frexp (value, eptr) 
double value; 
int •eptr; 

double Idexp (value, exp) 
double value; 
int exp; 

double modf (value, iptr) 
double value, *iptr; 

DESCRIPTION 

Every non-zero number can be written uniquely as x * 2", where the "mantissa" 
(fraction) x is in the range 0.5 < \x\ < 1.0, and the "exponent" n is an 
integer. Frexp returns the mantissa of a double value, and stores the exponent 
indirectly in the location pointed to by eptr. If value is zero, both results 
returned by frexp are zero. 

Ldexp returns the quantity value * 2^*^. 

Modf returns the signed fractional part of value and stores the integral part 
indirectly in the location pointed to by iptr. 

DIAGNOSTICS 

If ldexp would cause overflow, ±HUGE is returned (according to the sign of 
value), and errno is set to ERANGE. 

If ldexp would cause underflow, zero is returned and errno is set to ERANGE. 
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NAME 

fseek, rewind, ftell — reposition a file pointer in a stream 

SYNOPSIS 

#include <stdio.h> 

int fseek (stream, offset, ptrname) 
FILE ^stream; 
long offset; 
int ptrname; 

void rewind (stream) 
FILE 'Stream; 

long ftell (stream) 
FILE 'Stream; 

DESCRIPTION 

Fseek sets the position of the next input or output operation on the stream. 
The new position is at the signed distance offset bytes from the beginning, from 
the current position, or from the end of the file, according as ptrname has the 
value 0, 1, or 2. 

Rewind {stream) is equivalent to fseekistream, OL, 0), except that no value is 
returned. 

Fseek and rewind undo any effects of ungetc (3S) . 

After fseek or rewind, the next operation on a file opened for update may be 
either input or output. 

Ftell returns the offset of the current byte relative to the beginning of the file 
associated with the named stream. 

SEE ALSO 

lseek(2), fopen(3S), popen(3S), ungetc(3S). 

DIAGNOSTICS 

Fseek returns non-zero for improper seeks, otherwise zero. An improper seek 
can be, for example, an fseek done on a file that has not been opened via fopen; 
in particular, fseek may not be used on a terminal, or on a file opened via 
popen (3S) . 

WARNING 

Although on the UNIX system an offset returned by ftell is measured in bytes, 
and it is permissible to seek to positions relative to that offset, portability to 
non-UNIX systems requires that an offset be used by fseek directly. Arithmetic 
may not meaningfully be performed on such an offset, which is not necessarily 
measured in bytes. 
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NAME 

ftw — walk a file tree 

SYNOPSIS 

#indude <ftw.h> 

int ftw (path, fn, depth) 
char *path; 
int (*fn) ( ); 
int depth; 

DESCRIPTION 

Ftw recursively descends the directory hierarchy rooted in path. For each 
object in the hierarchy, ftw calls fn, passing it a pointer to a null-terminated 
character string containing the name of the object, a pointer to a stat structure 
(see Stat (2)) containing information about the object, and an integer. Possible 
values of the integer, defined in the <ftw.h> header file, are FTW F for a file, 
FTW D for a directory, FTW DNR for a directory that cannot be read, and 
FTW NS for an object for which stat could not successfully be executed. If the 
integer is FTW DNR, descendants of that directory will not be processed. If the 
integer is FTW NS, the stat structure will contain garbage. An example of an 
object that would cause FTW NS to be passed to fn would be a file in a direc- 
tory with read but without execute (search) permission. 

Ftw visits a directory before visiting any of its descendants. 

The tree traversal continues until the tree is exhausted, an invocation of fn 
returns a nonzero value, or some error is detected within ftw (such as an I/O 
error) . If the tree is exhausted, ftw returns zero. If fn returns a nonzero value, 
ftw stops its tree traversal and returns whatever value was returned by fn. If 
ftw detects an error, it returns —1, and sets the error type in errno. 

Ftw uses one file descriptor for each level in the tree. The depth argument 
limits the number of file descriptors so used. If depth is zero or negative, the 
effect is the same as if it were 1. Depth must not be greater than the number 
of file descriptors currently available for use. Ftw will run more quickly if 
depth is at least as large as the number of levels in the tree. 

SEE ALSO 

stat(2), mallocOC). 

BUGS 

Because ftw is recursive, it is possible for it to terminate with a memory fault 
when applied to very deep file structures. 

It could be made to run faster and use less storage on deep structures at the 
cost of considerable complexity. 

Ftw uses malloc(3C) to allocate dynamic storage during its operation. If ftw is 
forcibly terminated, such as by longjmp being executed by fn or an interrupt 
routine, ftw will not have a chance to free that storage, so it will remain per- 
manently allocated. A safe way to handle interrupts is to store the fact that an 
interrupt has occurred, and arrange to have fn return a nonzero value at its 
next invocation. 



- 1 - 



GETCOS) 



GETCOS) 



NAME 

getc, getchar, fgetc, getw — get character or word from a stream 

SYNOPSIS 

#iiiclude <stdio.h> 

int getc (stream) 
FILE •stream; 

int getchar ( ) 

int fgetc (stream) 
FILE *stream; 

int getw (stream) 
FILE *stream; 

DESCRIPTION 

Getc returns the next character (i.e., byte) from the named input stream, as an 
integer. It also moves the file pointer, if defined, ahead one character in 
stream. Getchar is defined as getc(stdin) . Getc and getchar are macros. 

Fgetc behaves like getc, but is a function rather than a macro. Fgetc runs 
more slowly than getc, but it takes less space per invocation and its name can 
be passed as an argument to a function. 

Getw returns the next word (i.e., integer) from the named input stream. Getw 
increments the associated file pointer, if defined, to point to the next word. The 
size of a word is the size of an integer and varies from machine to machine. 
Getw assumes no special alignment in the file. 

SEE ALSO 

fcloseOS), ferrorOS), fopenOS), fread(3S), getsOS), putcOS), scanf(3S). 
DIAGNOSTICS 

These functions return the constant EOF at end-of-file or upon an error. 
Because EOF is a valid integer, /error (3S) should be used to detect getw errors. 

WARNING 

If the integer value returned by getc, getchar, or fgetc is stored into a character 
variable and then compared against the integer constant EOF, the comparison 
may never succeed, because sign-extension of a character on widening to 
integer is machine-dependent. 

BUGS 

Because it is implemented as a macro, getc treats incorrectly a stream argu- 
ment with side effects. In particular, getc(«f-l— 1-) does not work sensibly. 
Fgetc should be used instead. 

Because of possible differences in word length and byte ordering, files written 
using putw are machine-dependent, and may not be read using getw on a 
different processor. 
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NAME 

getcwd — get path-name of current working directory 

SYNOPSIS 

char 'getcwd (buf, size) 
char 'buf; 
int size; 

DESCRIPTION 

Getcwd returns a pointer to the current directory path-name. The value of size 
must be at least two greater than the length of the path-name to be returned. 

If buf is a NULL pointer, getcwd will obtain size bytes of space using 
malloc {3C). In this case, the pointer returned by getcwd may be used as the 
argument in a subsequent call to free. 

The function is implemented by using popen(3S) to pipe the output of the 
pwdU) command into the specified string space. 

EXAMPLE 

char *cwd, *getcwd(); 



if ((cwd = getcwd ((char *)NULL, 64)) — NULL) { 
perror("pwd"); 
exit(l); 

} 

printf("%s\n", cwd); 

SEE ALSO 

malloc(3C), popen(3S). 

pwd(l) in the UNIX System V User Reference Manual. 
DIAGNOSTICS 

Returns NULL with errno set if size is not large enough, or if an error ocurrs in 
a lower-level function. 
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NAME 

getenv — return value for environment name 

SYNOPSIS 

char 'getenv (name) 
char *nanie; 

DESCRIPTION 

Getenv searches the environment list (see environ(5)) for a string of the form 
name =value, and returns a pointer to the value in the current environment if 
such a string is present, otherwise a NULL pointer. 

SEE ALSO 

exec (2), putenv(3C), environ (5). 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent, fgetgrent — get group file 
entry 

SYNOPSIS 

#include <grp.h> 

struct group 'getgrent ( ) 

struct group ^getgrgid (gid) 
int gid; 

struct group •getgrnam (name) 
char *name; 

void setgrent ( ) 

void endgrent ( ) 

struct group 'fgetgrent (f) 
FILE 'f; 

DESCRIPTION 

Getgrent, getgrgid and getgrnam each return pointers to an object with the fol- 
lowing structure containing the broken-out fields of a line in the /etc/group file. 
Each line contains a "group" structure, defined in the <grp.h> header file. 

struct group { 

char *gr_name; /• the name of the group •/ 

char *gr_passwd; /* the encrypted group password */ 

int grjgid; /* the numerical group ID */ 

char **gr_mem; /♦ vector of pointers to member names ♦/ 

}; 

Getgrent when first called returns a pointer to the first group structure in the 
file; thereafter, it returns a pointer to the next group structure in the file; so, 
successive calls may be used to search the entire file. Getgrgid searches from 
the beginning of the file until a numerical group id matching gid is found and 
returns a pointer to the particular structure in which it was found. Getgrnam 
searches from the beginning of the file until a group name matching name is 
found and returns a pointer to the particular structure in which it was found. 
If an end-of-file or an error is encountered on reading, these functions return a 
NULL pointer. 

A call to setgrent has the effect of rewinding the group file to allow repeated 
searches. Endgrent may be called to close the group file when processing is 
complete. 

Fgetgrent returns a pointer to the next group structure in the stream /, which 
matches the format of /etc/group. 

FILES 

/etc/group 

SEE ALSO 

getloginOC), getpwent(3C), group(4). 

DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 

BUGS 

All information is contained in a static area, so it must be copied if it is to be 
saved. 
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NAME 

getlogin — get login name 

SYNOPSIS 

char *getlogin ( ); 

DESCRIPTION 

Getlogin returns a pointer to the login name as found in /etc/utmp. It may be 
used in conjunction with getpwnam to locate the correct password file entry 
when the same user ID is shared by several login names. 

If getlogin is called within a process that is not attached to a terminal, it 
returns a NULL pointer. The correct procedure for determining the login name 
is to call cuserid, or to call getlogin and if it fails to call getpwuid. 

FILES 

/etc/utmp 
SEE ALSO 

cuserid (3S), getgrent(3C), getp'went(3C), utmp(4). 

DIAGNOSTICS 

Returns the NULL pointer if name is not found. 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

getopt — get option letter from argument vector 

SYNOPSIS 

int getopt (argc, argv, optstring) 
int argc; 

char **argv, •opstring; 

extern char «optarg; 
extern int optind, opterr; 

DESCRIPTION 

Getopt returns the next option letter in argv that matches a letter in optstring. 
Optstring is a string of recognized option letters; if a letter is followed by a 
colon, the option is expected to have an argument that may or may not be 
separated from it by white space. Optarg is set to point to the start of the 
option argument on return from getopt. 

Getopt places in optind the argv index of the next argument to be processed. 
Because optind is external, it is normally initialized to zero automatically 
before the first call to getopt. 

When all options have been processed (i.e., up to the first non-option argu- 
ment), getopt returns EOF. The special option may be used to delimit the 

end of the options; EOF will be returned, and will be skipped. 

DIAGNOSTICS 

Getopt prints an error message on stderr and returns a question mark (?) when 
it encounters an option letter not included in optstring. This error message 
may be disabled by setting opterr to a non-zero value. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a 
command that can take the mutually exclusive options a and b, and the options 
f and 0, both of which require arguments: 

main (argc, argv) 
int argc; 
char **argv; 
{ 

int c; 

extern char *optarg; 
extern int optind; 

while ((c = getopt(argc, argv, "abf:o:")) != EOF) 
switch (c) { 
case 'a': 

if (bflg) 

errflg++; 

else 

aflg++; 

break; 

case 'b': 

if (aflg) 

errflg+-l-; 

else 

bproc( ); 

break; 

case 'f: 

ifile == optarg; 
break; 
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case 'o': 

ofile = optarg; 
break; 

case '?': 

errflg++; 

} 

if (errflg) { 

fprintf(stderr, "usage: . . . "); 
exit (2); 

} 

for ( ; optind < argc; optind++) { 
if (access(argv[optind], 4)) { 

} 

SEE ALSO 

getopt(l) in the UNIX System V User Reference Manual. 
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NAME 

getpass — read a password 

SYNOPSIS 

char 'getpass (prompt) 
char •prompt; 

DESCRIPTION 

Getpass reads up to a newline or EOF from the file /dev/tty, after prompting on 
the standard error output with the null-terminated string prompt and disabling 
echoing. A pointer is returned to a null-terminated string of at most 8 charac- 
ters. If /dev/tty cannot be opened, a NULL pointer is returned. An interrupt 
will terminate input and send an interrupt signal to the calling program before 
returning. 

FILES 

/dev/tty 

SEE ALSO 

cryptOC). 

WARNING 

The above routine uses <stdio.h>, which causes it to increase the size of pro- 
grams not otherwise using standard I/O, more than might be expected. 



BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

getpw — get name from UID 

SYNOPSIS 

int getpw (uid, buf) 
int uid; 
char 'buf; 

DESCRIPTION 

Getpw searches the password file for a user id number that equals uid, copies 
the line of the password file in which uid was found into thie array pointed to 
by buf, and returns 0. Getpw returns non-zero if uid cannot be found. 

This routine is included only for compatibility with prior systems and should 
not be used; see getpwent (3C) for routines to use instead. 

FILES 

/etc/passwd 

SEE ALSO 

getpwent (3C), passwd(4). 

DIAGNOSTICS 

Getpw returns non-zero on error. 



WARNING 

The above routine uses <stdio.h>, which causes it to increase, more than 
might be expected, the size of programs not otherwise using standard I/O. 
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NAME 

getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent — get password 
file entry 

SYNOPSIS 

#include <pwd.h> 

struct passwd •getpwent ( ) 

struct passwd «getpwuid (uid) 
int uid; 

struct passwd *getpwnam (name) 
char 'name; 

void setpwent ( ) 

void endpwent ( ) 

struct passwd 'fgetpwent (f) 
FILE 'f; 

DESCRIPTION 

Getpwent, getpwuid and getpwnam each returns a pointer to an object with the 
following structure containing the broken-out fields of a line in the /etc/passwd 
file. Each line in the file contains a "passwd" structure, declared in the 
<pwd.h> header file: 

struct passwd { 



char 


*pw_name; 


char 


♦pw__passwd; 


int 


pwuid; 


int 


pwjgid; 


char 


*pw_age; 


char 


*pw_comment; 


char 


*pw_gecos; 


char 


*pw_dir; 


char 


♦pwshell; 



}; 

This structure is declared in <pwd.h> so it is not necessary to redeclare it. 

The pw comment field is unused; the others have meanings described in 
passwd (4) . 

Getpwent when first called returns a pointer to the first passwd structure in the 
file; thereafter, it returns a pointer to the next passwd structure in the file; so 
successive calls can be used to search the entire file. Getpwuid searches from 
the beginning of the file until a numerical user id matching uid is found and 
returns a pointer to the particular structure in which it was found. Getpwnam 
searches from the beginning of the file until a login name matching name is 
found, and returns a pointer to the particular structure in which it was found. 
If an end-of-file or an error is encountered on reading, these functions return a 
NULL pointer. 

A call to setpwent has the effect of rewinding the password file to allow 
repeated searches. Endpwent may be called to close the password file when 
processing is complete. 

Fgetpwent returns a pointer to the next passwd structure in the stream /, which 
matches the format of /etc/passwd. 

FILES 

/etc/passwd 
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SEE ALSO 

getloginOC), getgrentOC), passwcl(4). 

DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 

BUGS 

All information is contained in a static area, so it must be copied if it is to be 
saved. 
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NAME 

gets, fgets — get a string from a stream 

SYNOPSIS 

#include <stdio.h> 

char 'gets (s) 
char •s; 

char 'fgets (s, i:, stream) 
char 's; 
int n; 

FILE *stream; 
DESCRIPTION 

Gets reads characters from the standard input stream, stdin, into the array 
pointed to by s, until a new-line character is read or an end-of-file condition is 
encountered. The new-line character is discarded and the string is terminated 
with a null character. 

Fgets reads characters from the stream into the array pointed to by s, until 
n—\ characters are read, or a new-line character is read and transferred to s, 
or an end-of-file condition is encountered. The string is then terminated with a 
null character. 

SEE ALSO 

ferrorOS), fopen(3S), fread(3S), getc(3S), scanfOS). 
DIAGNOSTICS 

If end-of-file is encountered and no characters have been read, no characters 
are transferred to s and a NULL pointer is returned. If a read error occurs, 
such as trying to use these functions on a file that has not been opened for 
reading, a NULL pointer is returned. Otherwise s is returned. 
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NAME 

getutent, getutid, getutline, pututline, setutent, endutent, utmpname — access 
utmp file entry 

SYNOPSIS 

#include <utinp.h> 

struct utmp *getutent ( ) 

struct utmp *getutid (id) 
struct utmp *id; 

struct utmp •getutline (line) 
struct utmp 'line; 

void pututline (utmp) 
struct utmp *utmp; 

void setutent ( ) 

void endutent ( ) 

void utmpname (file) 
char •file; 

DESCRIPTION 

Getutent, getutid and getutline each return a pointer to a structure of the fol- 
lowing type: 

struct utmp { 

char ut_user[8]; /* User login name ♦/ 

char ut_id[4]; /» /etc/inittab id (usually line #) */ 

char ut_line[12]; /* device name (console, Inxx) ♦/ 

short utjpid; /* process id */ 

short ut_type; /* type of entry */ 

struct exit status { 

short e_termination; /* Process termination status */ 
short e_exit; /* Process exit status */ 

} ut exit; /* The exit status of a process 

* marked as DEAD PROCESS. */ 
time_t ut_time; /* time entry was made ♦/ 

}; 

Getutent reads in the next entry from a utmp-Xike, file. If the file is not already 
open, it opens it. If it reaches the end of the file, it fails. 

Getutid searches forward from the current point in the utmp file until it finds 
an entry with a utjype matching id — >ut_type if the type specified is 
RUN LVL, BOOT_TIME, OLD_TIME or NEW TIME. If the type specified in id 
is IN IT PROCESS, LOGIN PROCESS, USER PROCESS or DEAD_PROCESS, 
then getutid will return a pointer to the first entry whose type is one of these 
four and whose utjd field matches id — >utjd. If the end of file is reached 
without a match, it fails. 

Getutline searches forward from the current point in the utmp file until it finds 
an entry of the type LOGIN PROCESS or USER PROCESS which also has a 
utjine string matching the line— .>ut line string. If the end of file is reached 
without a match, it fails. 

Pututline writes out the supplied utmp structure into the utmp file. It uses 
getutid to search forward for the proper place if it finds that it is not already at 
the proper place. It is expected that normally the user of pututline will have 
searched for the proper entry using one of the getut routines. If so, pututline 
will not search. If pututline does not find a matching slot for the new entry, it 
will add a new entry to the end of the file. 
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Setutent resets the input stream to the beginning of the file. This should be 
done before each search for a new entry if it is desired that the entire file be 
examined. 

Endutent closes the currently open file. 

Utmpname allows the user to change the name of the file examined, from 
/etc/utmp to any other file. It is most often expected that this other file will be 
/etc/wtmp. If the file does not exist, this will not be apparent until the first 
attempt to reference the file is made. Utmpname does not open the file. It just 
closes the old file if it is currently open and saves the new file name. 

FILES 

/etc/utmp 
/etc/wtmp 

SEE ALSO 

ttyslot(3C), utmp(4). 

DIAGNOSTICS 

A NULL pointer is returned upon failure to read, whether for permissions or 
having reached the end of file, or upon failure to write. 

COMMENTS 

The most current entry is saved in a static structure. Multiple accesses require 
that it be copied before further accesses are made. Each call to either getutid 
or getutline sees the routine examine the static structure before performing 
more I/O. If the contents of the static structure match what it is searching for, 
it looks no further. For this reason to use getutline to search for multiple 
occurrences, it would be necessary to zero out the static after each success, or 
getutline would just return the same pointer over and over again. There is one 
exception to the rule about removing the structure before further reads are 
done. The implicit read done by pututline (if it finds that it is not already at 
the correct place in the file) will not hurt the contents of the static structure 
returned by the getutent, getutid or getutline routines, if the user has just 
modified those contents and passed the pointer back to pututline. 

These routines use buffered standard I/O for input, but pututline uses an 
unbuffered non-standard write to avoid race conditions between processes trying 
to modify the utmp and wtmp files. 
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NAME 

hsearch, hcreate, hdestroy — manage hash search tables 

SYNOPSIS 

#include <search.h> 

ENTRY •hsearch (item, action) 
ENTRY item; 
ACTION action; 

int hcreate (nel) 
unsigned nel; 

void hdestroy ( ) 

DESCRIPTION 

Hsearch is a hash-table search routine generalized from Knuth (6.4) Algorithm 
D. It returns a pointer into a hash table indicating the location at which an 
entry can be found. Item is a structure of type ENTRY (defined in the 
<search.h> header file) containing two pointers: item. key points to the com- 
parison key, and item.data points to any other data to be associated with that 
key. (Pointers to types other than character should be cast to pointer-to- 
character.) Action is a member of an enumeration type ACTION indicating the 
disposition of the entry if it cannot be found in the table. ENTER indicates that 
the item should be inserted in the table at an appropriate point. FIND indicates 
that no entry should be made. Unsuccessful resolution is indicated by the 
return of a NULL pointer. 

Hcreate allocates sufficient space for the table, and must be called before 
hsearch is used. Nel is an estimate of the maximum number of entries that 
the table will contain. This number may be adjusted upward by the algorithm 
in order to obtain certain mathematically favorable circumstances. 

Hdestroy destroys the search table, and may be followed by another call to 
hcreate. 

NOTES 

Hsearch uses open addressing with a multiplicative hash function. However, 
its source code has many other options available which the user may select by 
compiling the hsearch source with the following symbols defined to the prepro- 
cessor: 

DIV Use the remainder modulo table size as the hash function 

instead of the multiplicative algorithm. 

USCR Use a User Supplied Comparison Routine for ascertaining 
table membership. The routine should be named hcompar 
and should behave in a mannner similar to strcmp (see 
string{2>C)). 

CHAINED Use a linked list to resolve collisions. If this option is 
selected, the following other options become available. 

START Place new entries at the beginning of the 

linked list (default is at the end) . 

SORTUP Keep the linked list sorted by key in ascend- 
ing order. 

SORTDOWN Keep the linked list sorted by key in des- 
cending order. 

Additionally, there are preprocessor flags for obtaining debugging printout 
(-DDEBUG) and for including a test driver in the calling routine 
(-DDRIVER). The source code should be consulted for further details. 
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EXAMPLE 

The following example will read in strings followed by two numbers and store 
them in a hash table, discarding duplicates. It will then read in strings and 
find the matching entry in the hash table and print it out. 

#include <stdio.h> 
#include < search. h> 

struct info { /• this is the info stored in the table */ 

int age, room; /» other than the key. */ 

}; 

#define NUM EMPL 5000 /* # of elements in search table •/ 

main( ) 
{ 

/* space to store strings •/ 
char string_space[NUM_EMPL*20]; 
/♦ space to store employee info ♦/ 
struct info info_space[NUM_EMPL]; 
/» next avail space in string_space ♦/ 
char »str_ptr = string space; 
/* next avail space in info space */ 
struct info 'infojjtr = info space; 
ENTRY item, »found_item, *hsearch( ); 
/* name to look for in table ♦/ 
char name_to_find[30]; 
int i - 0; 



/* create table */ 

(void) hcreate(NUM_EMPL); 

while (scanf("%s%d%d", str_ptr, &info_ptr— >age, 

&infojptr->room) != EOF && i++ < NUM_EMPL) { 

/» put info in structure, and structure in item •/ 

item. key — str_ptr; 

item.data = (char »)info_ptr; 

strjjtr += strlen(str_ptr) + 1; 

info_ptr++; 

/♦ put item into table */ 
(void) hsearchGtem, ENTER); 

} 

/♦ access table */ 

item.key name_to_find; 

while (scanf("%s", item.key) !== EOF) { 

if ((foundjtem = hsearchdtem, FIND)) != NULL) { 
/* if item is in the table */ 

(void) printf ("found %s, age == %d, room = %d\n", 
foundjtem— > key, 

((struct info ♦) foundjtem— > data) — > age, 
((struct info •)foundjtem— > data) — > room); 

} else { 

(void) printf ("no such employee %s\n", 
name to find) 

} 

} 

} 
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SEE ALSO 

bsearchOC), IsearchOC), mallocOC), mallocOX), stringOC), tsearchOC). 
DIAGNOSTICS 

H search returns a NULL pointer if either the action is FIND and the item could 
not be found or the action is ENTER and the table is full. 

Hcreate returns zero if it cannot allocate sufficient space for the table. 

WARNING 

Hsearch and hcreate use malloc (3C) to allocate space. 

BUGS 

Only one hash search table may be active at any given time. 
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NAME 

13tol, ltol3 — convert between 3-byte integers and long integers 

SYNOPSIS 

void l3tol dp, cp, n) 
long 'Ip; 
char 'cp; 
int n; 

void ltol3 (cp, Ip, n) 
char *cp; 
long 'Ip; 
int n; 

DESCRIPTION 

L3tol converts a list of n three-byte integers packed into a character string 
pointed to by cp into a list of long integers pointed to by Ip. 

Ltol3 performs the reverse conversion from long integers ilp) to three-byte 
integers {cp). 

These functions are useful for file-system maintenance where the block 
numbers are three bytes long. 

SEE ALSO 

fs(4). 

BUGS 

Because of possible differences in byte ordering, the numerical values of the 
long integers are machine-dependent. 
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NAME 

Isearch, Ifind — linear search and update 

SYNOPSIS 

#include <stdio.h> 
#include <search.h> 

char 'Isearch ((char ♦)key, (char *)base, nelp, sizeof(*key), compar) 
unsigned *nelp; 
int (•conipar)( ); 

char •Ifind ((char •)key, (char »)base, nelp, sizeof(*key), compar) 
unsigned "nelp; 
int (•compar) ( ); 

DESCRIPTION 

Lsearch is a linear search routine generalized from Knuth (6.1) Algorithm S. 
It returns a pointer into a table indicating where a datum may be found. If the 
datum does not occur, it is added at the end of the table. Key points to the 
datum to be sought in the table. Base points to the first element in the table. 
Nelp points to an integer containing the current number of elements in the 
table. The integer is incremented if the datum is added to the table. Compar 
is the name of the comparison function which the user must supply {strcmp, for 
example). It is called with two arguments that point to the elements being 
compared. The function must return zero if the elements are equal and non- 
zero otherwise. 

Lfind is the same as Isearch except that if the datum is not found, it is not 
added to the table. Instead, a NULL pointer is returned. 

NOTES 

The pointers to the key and the element at the base of the table should be of 
type pointer-to-element, and cast to type pointer-to-character. 
The comparison function need not compare every byte, so arbitrary data may 
be contained in the elements in addition to the values being compared. 
Although declared as type pointer-to-character, the value returned should be 
cast into type pointer-to-element. 

EXAMPLE 

This fragment will read in ^ TABSIZE strings of length < ELSIZE and store 
them in a table, eliminating duplicates. 

#include <stdio.h> 
#include < search. h> 

#define TABSIZE 50 
#define ELSIZE 120 

char line[ELSIZE], tab[TABSIZE][ELSIZE], *lsearch( ); 
unsigned nel = 0; 
int strcmp ( ); 

while (fgetsdine, ELSIZE, stdin) != NULL && 
nel < TABSIZE) 

(void) Isearch (line, (char *)tab, &nel, 
ELSIZE, strcmp); 

SEE ALSO 

bsearch(3C), hsearch(3C), tsearch(3C). 
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DIAGNOSTICS 

If the searched for datum is found, both Isearch and Ifind return a pointer to 
it. Otherwise, Ifind returns NULL and Isearch returns a pointer to the newly 
added element. 

BUGS 

Undefined results can occur if there is not enough room in the table to add a 
new item. 
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NAME 

malloc, free, realloc, calloc — main memory allocator 

SYNOPSIS 

char *malloc (size) 
unsigned size; 

void free (ptr) 
cliar 'ptr; 

char *realloc (ptr, size) 
char 'ptr; 
unsigned size; 

char *calioc (nelem, elsize) 
unsigned nelem, elsize; 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package. 
Malloc returns a pointer to a block of at least size bytes suitably aligned for 
any use. 

The argument to free is a pointer to a block previously allocated by malloc; 
after free is performed this space is made available for further allocation, but 
its contents are left undisturbed. 

Undefined results will occur if the space assigned by malloc is overrun or if 
some random number is handed to free. 

Malloc allocates the first big enough contiguous reach of free space found in a 
circular search from the last block allocated or freed, coalescing adjacent free 
blocks as it searches. It calls sbrk (see brkil)) to get more memory from the 
system when there is no suitable space already free. 

Realloc changes the size of the block pointed to by ptr to size bytes and 
returns a pointer to the (possibly moved) block. The contents will be 
unchanged up to the lesser of the new and old sizes. If no free block of size 
bytes is available in the storage arena, then realloc will ask malloc to enlarge 
the arena by size bytes and will then move the data to the new space. 

Realloc also works if ptr points to a block freed since the last call of malloc, 
realloc, or calloc; thus sequences of free, malloc and realloc can exploit the 
search strategy of malloc to do storage compaction. 

Calloc allocates space for an array of nelem elements of size elsize. The space 
is initialized to zeros. 

Each of the allocation routines returns a pointer to space suitably aligned (after 
possible pointer coercion) for storage of any type of object. 

SEE ALSO 

brk(2), mallocOX). 

DIAGNOSTICS 

Malloc, realloc and calloc return a NULL pointer if there is no available 
memory or if the arena has been detectably corrupted by storing outside the 
bounds of a block. When this happens the block pointed to by ptr may be des- 
troyed. 

NOTE 

Search time increases when many objects have been allocated; that is, if a pro- 
gram allocates but never frees, then each successive allocation takes longer. 
For an alternate, more flexible implementation, see malloc i3X). 
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NAME 

memccpy, memchr, memcmp, memcpy, memset — memory operations 

SYNOPSIS 

#include < memory .h> 

char *memccpy (si, s2, c, n) 
char *sl, •si; 
int c, n; 

char *memchr is, c, n) 
char •s; 
int c, n; 

int memcmp (si, s2, n) 
char 'sl, *s2; 
int n; 

char 'memcpy (si, s2, n) 
char 'sl, *s2; 
int n; 

char •memset (s, c, n) 
char *s; 
int c, n; 

DESCRIPTION 

These functions operate as efficiently as possible on memory areas (arrays of 
characters bounded by a count, not terminated by a null character). They do 
not check for the overflow of any receiving memory area. 

Memccpy copies characters from memory area s2 into si, stopping after the 
first occurrence of character c has been copied, or after n characters have been 
copied, whichever comes first. It returns a pointer to the character after the 
copy of c in si, or a NULL pointer if c was not found in the first n characters 
of s2. 

Memchr returns a pointer to the first occurrence of character c in the first n 
characters of memory area s, or a NULL pointer if c does not occur. 

Memcmp compares its arguments, looking at the first n characters only, and 
returns an integer less than, equal to, or greater than 0, according as si is lexi- 
cographically less than, equal to, or greater than s2. 

Memcpy copies n characters from memory area s2 to si. It returns si. 

Memset sets the first n characters in memory area s to the value of character 
c. It returns s. 

NOTE 

For user convenience, all these functions are declared in the optional 
< memory. h> header file. 

BUGS 

Memcmp uses native character comparison, which is signed on PDP-lls and 
VAX- lis, unsigned on other machines. Thus the sign of the value returned 
when one of the characters has its high-order bit set is implementation- 
dependent. 

Character movement is performed differently in different implementations. 
Thus overlapping moves may yield surprises. 
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NAME 

mktemp — make a unique file name 

SYNOPSIS 

char *niktemp (template) 
char *tempiate; 

DESCRIPTION 

Mktemp replaces the contents of the string pointed to by template by a unique 
file name, and returns the address of template. The string in template should 
look like a file name with six trailing Xs; mktemp will replace the Xs with a 
letter and the current process ID. The letter will be chosen so that the resulting 
name does not duplicate an existing file. 

SEE ALSO 

getpid(2), tmpfileOS), tmpnam(3S). 

BUGS 

It is possible to run out of letters. 
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NAME 

monitor — prepare execution profile 

SYNOPSIS 

#include <mon.h> 

void monitor (lowpc, highpc, buffer, bufsize, nfunc) 
int ('lowpc) ( ), (»highpc)( ); 
WORD 'buffer; 
int bufsize, nfunc; 

DESCRIPTION 

An executable program created by cc — p automatically includes calls for mon- 
itor with default parameters; monitor needn't be called explicitly except to gain 
fine control over profiling. 

Monitor is an interface to profilO). Lowpc and highpc are the addresses of 
two functions; buffer is the address of a (user supplied) array of bufsize 
WORDS (defined in the <mon.h> header file). Monitor arranges to record a 
histogram of periodically sampled values of the program counter, and of counts 
of calls of certain functions, in the buff"er. The lowest address sampled is that 
of lowpc and the highest is just below highpc. Lowpc may not equal 0 for this 
use of monitor. At most nfunc call counts can be kept; only calls of functions 
compiled with the profiling option — p of cc{\) are recorded. (Except on the 
PDP-11, the C Library and Math Library supplied when cc — p is used also 
have call counts recorded.) 

For the results to be significant, especially where there are small, heavily used 
routines, it is suggested that the buffer be no more than a few times smaller 
than the range of locations sampled. 

To profile the entire program, it is sufficient to use 

extern etext; 

monitor ((int (*)())2, etext, buf, bufsize, nfunc); 
Etext lies just above all the program text; see endiliO. 
To stop execution monitoring and write the results on the file mon.out, use 

monitor ((int (*)())0, 0, 0, 0, 0); 
Prof{\) can then be used to examine the results. 

FILES 

mon.out 

/lib/libp/libc.a 

/lib/libp/libm.a 

SEE ALSO 

profil(2), endOC). 

cc(l), prof(l) in the UNIX System V User Reference Manual. 
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NAME 

nlist — get entries from name list 

SYNOPSIS 

#include <nlist.h> 

int nlist (file-name, nl) 
char *file-name; 
struct nlist *nl; 

DESCRIPTION 

Nlist examines the name list in the executable file whose name is pointed to by 
file-name, and selectively extracts a list of values and puts them in the array of 
nlist structures pointed to by nl. The name list nl consists of an array of struc- 
tures containing names of variables, types and values. The list is terminated 
with a null name; that is, a null string is in the name position of the structure. 
Each variable name is looked up in the name list of the file. If the name is 
found, the type and value of the name are inserted in the next two fields. The 
type field will be set to 0 unless the file was compiled with the — g option. If 
the name is not found, both entries are set to 0. See a.outiA) for a discussion 
of the symbol table structure. 

This function is useful for examining the system name list kept in the file 
/unix. In this way programs can obtain system addresses that are up to date. 

NOTES 

The < nlist. h> header file is automatically included by <a.out.h> for compa- 
tability. However, if the only information needed from <a.out.h> is for use of 
nlist, then including <a.out.h> is discouraged. If <a.out.h> is included, the 
line "#undef n name" may need to follow it. 

SEE ALSO 

a. out (4). 

DIAGNOSTICS 

All value entries are set to 0 if the file cannot be read or if it does not contain a 
valid name list. 

Nlist returns —1 upon error; otherwise it returns 0. 
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NAME 

perror, errno, sys errlist, sys nerr — system error messages 

SYNOPSIS 

void perror (s) 
char *s; 

extern int errno; 
extern char •sys_errlist[ 1; 
extern int sys nerr; 
DESCRIPTION 

Perror produces a message on the standard error output, describing the last 
error encountered during a call to a system or library function. The argument 
string s is printed first, then a colon and a blank, then the message and a new- 
line. To be of most use, the argument string should include the name of the 
program that incurred the error. The error number is taken from the external 
variable errno, which is set when errors occur but not cleared when non- 
erroneous calls are made. 

To simplify variant formatting of messages, the array of message strings 
sys errlist is provided; errno can be used as an index in this table to get the 
message string without the new-line. Sysjierr is the largest message number 
provided for in the table; it should be checked because new error codes may be 
added to the system before they are added to the table. 

SEE ALSO 

intro(2). 



- 1 - 



POPENOS) 



POPENOS) 



NAME 

popen, pclose — initiate pipe to/from a process 

SYNOPSIS 

#include <stdio.h> 

FILE *popen (command, type) 
char 'command, *type; 

int pclose (stream) 
FILE *stream; 

DESCRIPTION 

The arguments to popen are pointers to null-terminated strings containing, 
respectively, a shell command line and an I/O mode, either r for reading or w 
for writing. Popen creates a pipe between the calling program and the com- 
mand to be executed. The value returned is a stream pointer such that one can 
write to the standard input of the command, if the I/O mode is w, by writing to 
the file stream; and one can read from the standard output of the command, if 
the I/O mode is r, by reading from the file stream. 

A stream opened by popen should be closed by pclose, which waits for the 
associated process to terminate and returns the exit status of the command. 

Because open files are shared, a type r command may be used as an input filter 
and a type w as an output filter. 

SEE ALSO 

pipe(2), wait(2), fclose(3S), fopen(3S), system(3S). 
DIAGNOSTICS 

Popen returns a NULL pointer if files or processes cannot be created, or if the 
shell cannot be accessed. 

Pclose returns —1 if stream is not associated with a "'popened''' command. 

BUGS 

If the original and "popened" processes concurrently read or write a common 
file, neither should use buffered I/O, because the buffering gets all mixed up. 
Problems with an output filter may be forestalled by careful buffer flushing, e.g. 
with fflush; see fcloseOS) . 
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NAME 

printf, fprintf, sprintf — print formatted output 

SYNOPSIS 

#include <stdio.h> 

int printf (format [ , arg ] . . . ) 
char •format; 

int fprintf (stream, format [ , arg ] ... ) 
FILE 'Stream; 
char 'format; 

int sprintf (s, format [ , arg ] ... ) 
char *s, format; 

DESCRIPTION 

Printf places output on the standard output stream stdout. Fprintf places out- 
put on the named output stream. Sprintf places "output," followed by the null 
character (\0), in consecutive bytes starting at *s\ it is the user's responsibility 
to ensure that enough storage is available. Each function returns the number 
of characters transmitted (not including the \0 in the case of sprintf), or a 
negative value if an output error was encountered. 

Each of these functions converts, formats, and prints its args under control of 
the format. The format is a character string that contains two types of 
objects: plain characters, which are simply copied to the output stream, and 
conversion specifications, each of which results in fetching of zero or more args. 
The results are undefined if there are insufficient orgs for the format. If the 
format is exhausted while orgs remain, the excess arg?, are simply ignored. 

Each conversion specification is introduced by the character %. After the %, 
the following appear in sequence: 

Zero or more flags, which modify the meaning of the conversion 
specification. 

An optional decimal digit string specifying a minimum field width. If 
the converted value has fewer characters than the field width, it will be 
padded on the left (or right, if the left-adjustment flag '— described 
below, has been given) to the field width. If the field width for an s 
conversion is preceded by a 0, the string is right adjusted with zero- 
padding on the left. 

A precision that gives the minimum number of digits to appear for the 
d, o, u, X, or X conversions, the number of digits to appear after the 
decimal point for the e and f conversions, the maximum number of 
significant digits for the g conversion, or the maximum number of 
characters to be printed from a string in s conversion. The precision 
takes the form of a period (.) followed by a decimal digit string; a null 
digit string is treated as zero. 

An optional I (ell) specifying that a following d, o, u, x, or X conver- 
sion character applies to a long integer arg. A I before any other 
conversion character is ignored. 

A character that indicates the type of conversion to be applied. 

A field width or precision may be indicated by an asterisk (•) instead of a digit 
string. In this case, an integer arg supplies the field width or precision. The 
arg that is actually converted is not fetched until the conversion letter is seen, 
so the args specifying field width or precision must appear before the arg (if 
any) to be converted. 
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The flag characters and their meanings are: 

— The result of the conversion will be left-justified within the field. 

+ The result of a signed conversion will always begin with a sign ( ■+- 

or -). 

blank If the first character of a signed conversion is not a sign, a blank 
will be prefixed to the result. This implies that if the blank and +■ 
flags both appear, the blank flag will be ignored. 

# This flag specifies that the value is to be converted to an "alternate 

form." For c, d, s, and u conversions, the flag has no effect. For o 
conversion, it increases the precision to force the first digit of the 
result to be a zero. For x or X conversion, a non-zero result will 
have Ox or OX prefixed to it. For e, E, f, g, and G conversions, the 
result will always contain a decimal point, even if no digits follow 
the point (normally, a decimal point appears in the result of these 
conversions only if a digit follows it). For g and G conversions, 
trailing zeroes will not be removed from the result (which they nor- 
mally are). 

The conversion characters and their meanings are: 

d, o,u,x,x The integer arg is converted to signed decimal, unsigned octal, 

decimal, or hexadecimal notation (x and X), respectively; the letters 
abcdef are used for x conversion and the letters ABCDEF for X 
conversion. The precision specifies the minimum number of digits 
to appear; if the value being converted can be represented in fewer 
digits, it will be expanded with leading zeroes. (For compatibility 
with older versions, padding with leading zeroes may alternatively 
be specified by prepending a zero to the field width. This does not 
imply an octal value for the field width.) The default precision is 1. 
The result of converting a zero value with a precision of zero is a 
null string. 

f The float or double arg is converted to decimal notation in the style 

"[ — Jddd.ddd," where the number of digits after the decimal point 
is equal to the precision specification. If the precision is missing, six 
digits are output; if the precision is explicitly 0, no decimal point 
appears. 

e, E The float or double arg is converted in the style "[ — ]d.ddde±dd," 

where there is one digit before the decimal point and the number of 
digits after it is equal to the precision; when the precision is miss- 
ing, six digits are produced; if the precision is zero, no decimal point 
appears. The E format code will produce a number with E instead 
of e introducing the exponent. The exponent always contains at 
least two digits. 

g,G The float or double arg is printed in style f or e (or in style E in the 

case of a G format code), with the precision specifying the number 
of significant digits. The style used depends on the value converted: 
style e will be used only if the exponent resulting from the conver- 
sion is less than —4 or greater than the precision. Trailing zeroes 
are removed from the result; a decimal point appears only if it is 
followed by a digit. 

c The character arg is printed. 

s The arg is taken to be a string (character pointer) and characters 

from the string are printed until a null character (\0) is encoun- 
tered or the number of characters indicated by the precision 
specification is reached. If the precision is missing, it is taken to be 
infinite, so all characters up to the first null character are printed. 
A NULL value for arg will yield undefined results. 
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% Print a %; no argument is converted. 

In no case does a non-existent or small field width cause truncation of a field; if 
the result of a conversion is wider than the field width, the field is simply 
expanded to contain the conversion result. Characters generated by print/ and 
/print/ are printed as if putc (3S) had been called. 

EXAMPLES 

To print a date and time in the form "Sunday, July 3, 10:02," where weekday 
and month are pointers to null-terminated strings: 

printf("%s, %s %d, %d:%.2d", weekday, month, day, hour, min); 

To print tt to 5 decimal places: 

printfC'pi = %.5r', 4 * atan(l.O)); 

SEE ALSO 

ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 

putc, putchar, fputc, putw — put character or word on a stream 

SYNOPSIS 

#include <stdio.h> 

int putc (c, stream) 
int c; 

FILE •stream; 

int putchar (c) 
int c; 

int fputc (c, stream) 
int c; 

FILE 'Stream; 

int putw (w, stream) 
int w; 

FILE 'stream; 
DESCRIPTION 

Putc writes the character c onto the output stream (at the position where the 
file pointer, if defined, is pointing). Putchar (c) is defined as putcic, stdout). 
Putc and putchar are macros. 

Fputc behaves Hke putc, but is a function rather than a macro. Fputc runs 
more slowly than putc, but it takes less space per invocation and its name can 
be passed as an argument to a function. 

Putw writes the word (i.e. integer) w to the output stream (at the position at 
which the file pointer, if defined, is pointing). The size of a word is the size of 
an integer and varies from machine to machine. Putw neither assumes nor 
causes special alignment in the file. 

Output streams, with the exception of the standard error stream stderr, are by 
default buffered if the output refers to a file and line-buffered if the output 
refers to a terminal. The standard error output stream stderr is by default 
unbuffered, but use of freopen (see fopen(3S)) will cause it to become buffered 
or line-buffered. When an output stream is unbuffered, information is queued 
for writing on the destination file or terminal as soon as written; when it is 
buffered, many characters are saved up and written as a block. When it is 
line-buffered, each line of output is queued for writing on the destination termi- 
nal as soon as the line is completed (that is, as soon as a new-line character is 
written or terminal input is requested). Setbuf OS) or Setbufi3S) may be used 
to change the stream's buffering strategy. 

SEE ALSO 

fcloseOS), ferrorOS), fopenOS), freadOS), printfOS), puts(3S), setbufOS). 
DIAGNOSTICS 

On success, these functions each return the value they have written. On 
failure, they return the constant EOF. This will occur if the file stream is not 
open for writing or if the output file cannot be grown. Because EOF is a valid 
integer, /error (3S) should be used to detect putw errors. 

BUGS 

Because it is implemented as a macro, putc treats incorrectly a stream argu- 
ment with side effects. In particular, putcCc, *f++); doesn't work sensibly. 
Fputc should be used instead. 

Because of possible differences in word length and byte ordering, files written 
using putw are machine-dependent, and may not be read using getw on a 
different processor. 
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NAME 

putenv — change or add value to environment 

SYNOPSIS 

int putenv (string) 
char *string; 

DESCRIPTION 

String points to a string of the form " name value." Putenv makes the value 
of the environment variable name equal to value by altering an existing vari- 
able or creating a new one. In either case, the string pointed to by string 
becomes part of the environment, so altering the string will change the environ- 
ment. The space used by string is no longer used once a new string-defining 
name is passed to putenv. 

DIAGNOSTICS 

Putenv returns non-zero if it was unable to obtain enough space via malloc for 
an expanded environment, otherwise zero. 

SEE ALSO 

exec(2), getenv(3C), malloc(3C), environ(5). 
WARNINGS 

Putenv manipulates the environment pointed to by environ, and can be used in 
conjunction with getenv. However, envp (the third argument to main) is not 
changed. 

This routine uses malloci3C) to enlarge the environment. 
After putenv is called, environmental variables are not in alphabetical order. 
A potential error is to call putenv with an automatic variable as the argument, 
then exit the calling function while string is still part of the environment. 
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NAME 

putpwent — write password file entry 

SYNOPSIS 

#include <pwd.h> 

int putpwent (p, f) 
struct passwd *p; 
FILE *f; 

DESCRIPTION 

Putpwent is the inverse of getpwenti3C). Given a pointer to a passwd struc- 
ture created by getpwent (or getpwuid or getpwnam) , putpwent writes a line on 
the stream /, which matches the format of /etc/passwd. 

DIAGNOSTICS 

Putpwent returns non-zero if an error was detected during its operation, other- 
wise zero. 

SEE ALSO 

getpwent (3 C). 

WARNING 

The above routine uses <stdio.h>, which causes it to increase the size of pro- 
grams, not otherwise using standard I/O, more than might be expected. 
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NAME 

puts, fputs — put a string on a stream 

SYNOPSIS 

#include <stdio.h> 

int puts (s) 
char *s; 

int fputs (s, stream) 
char *s; 
FILE «stream; 

DESCRIPTION 

Puts writes the null-terminated string pointed to by s, followed by a new-line 
character, to the standard output stream stdout. 

Fputs writes the null-terminated string pointed to by s to the named output 
stream . 

Neither function writes the terminating null character. 
DIAGNOSTICS 

Both routines return EOF on error. This will happen if the routines try to write 
on a file that has not been opened for writing. 

SEE ALSO 

ferrorOS), fopenOS), fread(3S), printfOS), putc(3S). 

NOTES 

Puts appends a new-line character while fputs does not. 
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NAME 

qsort — quicker sort 
SYNOPSIS 

void qsort ((char *) base, nel, sizeof ('base), compar) 

unsigned nel; 

int (•compar) ( ); 

DESCRIPTION 

Qsort is an implementation of the quicker-sort algorithm. It sorts a table of 
data in place. 

Base points to the element at the base of the table. Nel is the number of ele- 
ments in the table. Compar is the name of the comparison function, which is 
called with two arguments that point to the elements being compared. As the 
function must return an integer less than, equal to, or greater than zero, so 
must the first argument to be considered be less than, equal to, or greater than 
the second. 

NOTES 

The pointer to the base of the table should be of type pointer-to-element, and 
cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may 

be contained in the elements in addition to the values being compared. 

The order in the output of two items which compare as equal is unpredictable. 

SEE ALSO 

bsearchOC), IsearchOC), string (3C). 

sort(l) in the UNIX System V User Reference Manual. 
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NAME 

rand, srand — simple random-number generator 

SYNOPSIS 

int rand ( ) 

void srand (seed) 
unsigned seed; 

DESCRIPTION 

Rand uses a multiplicative congruential random-number generator with period 
2^^ that returns successive pseudo-random numbers in the range from 0 to 
2'^-l. 

Srand can be called at any time to reset the random-number generator to a 
random starting point. The generator is initially seeded with a value of 1 . 

NOTE 

The spectral properties of rand leave a great deal to be desired. Drand48{3C) 
provides a much better, though more elaborate, random-number generator. 

SEE ALSO 

drand48(3C). 
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NAME 

scanf, fscanf, sscanf — convert formatted input 

SYNOPSIS 

#include <stdio.h> 

int scanf (format [ , pointer ] ... ) 
char *format; 

int fscanf (stream, format [ , pointer ] ... ) 
FILE 'Stream; 
char 'format; 

int sscanf (s, format [ , pointer ] . . . ) 
char *s, *format; 

DESCRIPTION 

Scanf reads from the standard input stream stdin. Fscanf reads from the 
named input stream. Sscanf reads from the character string s. Each function 
reads characters, interprets them according to a format, and stores the results 
in its arguments. Each expects, as arguments, a control string format 
described below, and a set of pointer arguments indicating where the converted 
input should be stored. 

The control string usually contains conversion specifications, which are used to 
direct interpretation of input sequences. The control string may contain: 

1. White-space characters (blanks, tabs, new-lines, or form-feeds) which, 
except in two cases described below, cause input to be read up to the next 
non-white-space character. 

2. An ordinary character (not %), which must match the next character of 
the input stream. 

3. Conversion specifications, consisting of the character %, an optional assign- 
ment suppressing character *, an optional numerical maximum field width, 
an optional 1 (ell) or h indicating the size of the receiving variable, and a 
conversion code. 

A conversion specification directs the conversion of the next input field; the 
result is placed in the variable pointed to by the corresponding argument, unless 
assignment suppression was indicated by *. The suppression of assignment pro- 
vides a way of describing an input field which is to be skipped. An input field 
is defined as a string of non-space characters; it extends to the next inappropri- 
ate character or until the field width, if specified, is exhausted. For all descrip- 
tors except "[" and "c", white space leading an input field is ignored. 

The conversion code indicates the interpretation of the input field; the 
corresponding pointer argument must usually be of a restricted type. For a 
suppressed field, no pointer argument is given. The following conversion codes 
are legal: 

% a single % is expected in the input at this point; no assignment is done, 
d a decimal integer is expected; the corresponding argument should be an 

integer pointer. 

u an unsigned decimal integer is expected; the corresponding argument 

should be an unsigned integer pointer, 
o an octal integer is expected; the corresponding argument should be an 

integer pointer. 
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X a hexadecimal integer is expected; the corresponding argument should 
be an integer pointer. 

e,f,g a floating point number is expected; the next field is converted accord- 
ingly and stored through the corresponding argument, which should be 
a pointer to a float. The input format for floating point numbers is an 
optionally signed string of digits, possibly containing a decimal point, 
followed by an optional exponent field consisting of an E or an e, fol- 
lowed by an optional +, — , or space, followed by an integer. 

s a character string is expected; the corresponding argument should be a 

character pointer pointing to an array of characters large enough to 
accept the string and a terminating \0, which will be added automati- 
cally. The input field is terminated by a white-space character. 

c a character is expected; the corresponding argument should be a char- 

acter pointer. The normal skip over white space is suppressed in this 
case; to read the next non-space character, use % Is. If a field width is 
given, the corresponding argument should refer to a character array; 
the indicated number of characters is read. 

I indicates string data and the normal skip over leading white space is 

suppressed. The left bracket is followed by a set of characters, which 
we will call the scanset, and a right bracket; the input field is the max- 
imal sequence of input characters consisting entirely of characters in 
the scanset. The circumflex ("), when it appears as the first character 
in the scanset, serves as a complement operator and redefines the scan- 
set as the set of all characters not contained in the remainder of the 
scanset string. There are some conventions used in the construction of 
the scanset. A range of characters may be represented by the con- 
struct first— last, thus [0123456789] may be expressed [0—9]. Using 
this convention, //-i/ must be lexically less than or equal to last, or else 
the dash will stand for itself. The dash will also stand for itself when- 
ever it is the first or the last character in the scanset. To include the 
right square bracket as an element of the scanset, it must appear as the 
first character (possibly preceded by a circumflex) of the scanset, and 
in this case it will not be syntactically interpreted as the closing 
bracket. The corresponding argument must point to a character array 
large enough to hold the data field and the terminating \0, which will 
be added automatically. At least one character must match for this 
conversion to be considered successful. 

The conversion characters d, u, o, and x may be preceded by 1 or h to indicate 
that a pointer to long or to short rather than to int is in the argument list. 
Similarly, the conversion characters e, f, and g may be preceded by 1 to indicate 
that a pointer to double rather than to float is in the argument list. The 1 or h 
modifier is ignored for other conversion characters. 

Scanf conversion terminates at EOF, at the end of the control string, or when 
an input character conflicts with the control string. In the latter case, the 
off"ending character is left unread in the input stream. 

Scanf returns the number of successfully matched and assigned input items; 
this number can be zero in the event of an early conflict between an input char- 
acter and the control string. If the input ends before the first conflict or 
conversion, EOF is returned. 
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EXAMPLES 

The call: 

int i, n; float x; char name[50]; 

n = scanf ("%d%f%s", &i, &x, name); 

with the input line: 

25 54.32E— 1 thompson 

will assign to n the value 3, to / the value 25, to x the value 5.432, and name 
will contain thompson\0. Or: 

int i; float x; char nanme[50]; 

(void) scanf ("%2d%f%*d %[0-9]", &i, &x, name); 

with input: 

56789 0123 56a72 

will assign 56 to /, 789.0 to x, skip 0123, and place the string 56\0 in name. 
The next call to getchar (see getc{2)S)) will return a. 

SEE ALSO 

getcOS), printfOS), strtodOC), strtolOC). 

NOTE 

Trailing white space (including a new-line) is left unread unless matched in the 
control string. 

DIAGNOSTICS 

These functions return EOF on end of input and a short count for missing or 
illegal data items. 

BUGS 

The success of literal matches and suppressed assignments is not directly deter- 
minable. 
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NAME 

setbuf, setvbuf — assign buffering to a stream 

SYNOPSIS 

#include <stdio.h> 

void setbuf (stream, buf) 
FILE •stream; 
char *buf; 

int setvbuf (stream, buf, type, size) 
FILE 'Stream; 
char «buf; 
int type, size; 

DESCRIPTION 

Setbuf may be used after a stream has been opened but before it is read or 
written. It causes the array pointed to by buf to be used instead of an 
automatically allocated buffer. If buf is the NULL pointer input/output will be 
completely unbuffered. 

A constant BUFSIZ, defined in the <stdio.h> header file, tells how big an 
array is needed: 

char bufleUFSlZ]; 

Setvbuf may be used after a stream has been opened but before it is read or 
written. Type determines how stream will be buffered. Legal values for type 
(defined in stdio.h) are: 

lOFBF causes input/output to be fully buffered. 

lOLBF causes output to be line buffered; the buffer will be flushed 

when a newline is written, the buffer is full, or input is 
requested. 

lONBF causes input/output to be completely unbuffered. 

If buf is not the NULL pointer, the array it points to will be used for buffering, 
instead of an automatically allocated buffer. Size specifies the size of the 
buffer to be used. The constant BUFSIZ in <stdio.h> is suggested as a good 
buffer size. If input/output is unbuffered, buf and size are ignored. 

By default, output to a terminal is line buffered and all other input/output is 
fully buffered. 

SEE ALSO 

fopen(3S), getc(3S), mallocOC), putc(3S), stdioOS). 
DIAGNOSTICS 

If an illegal value for type or size is provided, setvbuf returns a non-zero value. 
Otherwise, the value returned will be zero. 

NOTE 

A common source of error is allocating buffer space as an "automatic" variable 
in a code block, and then failing to close the stream in the same block. 
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NAME 

setjmp, longjmp — non-local goto 

SYNOPSIS 

#include <setjmp.h> 

int setjmp (env) 
jmp buf env; 

void longjmp (env, val) 
jmp buf env; 
int val; 

DESCRIPTION 

These functions are useful for dealing with errors and interrupts encountered in 
a low-level subroutine of a program. 

Setjmp saves its stack environment in env (whose type, jmp_buf, is defined in 
the <setjmp.h> header file) for later use by longjmp. It returns the value 0. 

Longjmp restores the environment saved by the last call of setjmp with the 
corresponding env argument. After longjmp is completed, program execution 
continues as if the corresponding call of setjmp (which must not itself have 
returned in the interim) had just returned the value val. Longjmp cannot 
cause setjmp to return the value 0. If longjmp is invoked with a second argu- 
ment of 0, setjmp will return 1. All accessible data had values as of the time 
longjmp was called. 

SEE ALSO 

signal (2). 

WARNING 

If longjmp is called even though env was never primed by a call to setjmp, or 
when the last such call was in a function which has since returned, absolute 
chaos is guaranteed. 
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NAME 

sleep — suspend execution for interval 

SYNOPSIS 

unsigned sleep (seconds) 
unsigned seconds; 

DESCRIPTION 

The current process is suspended from execution for the number of seconds 
specified by the argument. The actual suspension time may be less than that 
requested for two reasons: (l) Because scheduled wakeups occur at fixed 1- 
second intervals, (on the second, according to an internal clock) and (2) 
because any caught signal will terminate the sleep following execution of that 
signal's catching routine. Also, the suspension time may be longer than 
requested by an arbitrary amount due to the scheduling of other activity in the 
system. The value returned by sleep will be the "unslept" amount (the 
requested time minus the time actually slept) in case the caller had an alarm 
set to go off earlier than the end of the requested sleep time, or premature 
arousal due to another caught signal. 

The routine is implemented by setting an alarm signal and pausing until it (or 
some other signal) occurs. The previous state of the alarm signal is saved and 
restored. The calling program may have set up an alarm signal before calling 
sleep. If the sleep time exceeds the time till such alarm signal, the process 
sleeps only until the alarm signal would have occurred. The caller's alarm 
catch routine is executed just before the sleep routine returns. But if the sleep 
time is less than the time till such alarm, the prior alarm time is reset to go off 
at the same time it would have without the intervening sleep . 

SEE ALSO 

alarm (2), pause (2), signal (2). 
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ssignal, gsignal — software signals 

SYNOPSIS 

#include <signal.h> 

int (*ssignal (sig, action)) ( ) 
int sig, (•action) ( ); 

int gsignal (sig) 
int sig; 



SSIGNALOC) 



DESCRIPTION 

Ssignal and gsignal implement a software facility similar to signal (2). This 
facility is used by the Standard C Library to enable users to indicate the dispo- 
sition of error conditions, and is also made available to users for their own pur- 
poses. 

Software signals made available to users are associated with integers in the 
inclusive range 1 through 15. A call to ssignal associates a procedure, action, 
with the software signal sig; the software signal, sig, is raised by a call to gsig- 
nal. Raising a software signal causes the action established for that signal to 
be taken. 

The first argument to ssignal is a number identifying the type of signal for 
which an action is to be established. The second argument defines the action; it 
is either the name of a (user-defined) action function or one of the manifest 
constants SIG_DFL (default) or SIG IGN (ignore). Ssignal returns the action 
previously established for that signal type; if no action has been established or 
the signal number is illegal, ssignal returns SIG DFL. 

Gsignal raises the signal identified by its argument, sig: 

If an action function has been established for sig, then that action is reset 
to SIG_DFL and the action function is entered with argument sig. Gsig- 
nal returns the value returned to it by the action function. 

If the action for sig is SIGJGN, gsignal returns the value 1 and takes no 
other action. 

If the action for sig is SIG_DFL, gsignal returns the value 0 and takes no 
other action. 

If sig has an illegal value or no action was ever specified for sig. gsignal 
returns the value 0 and takes no other action. 

SEE ALSO 

signal (2). 

NOTES 

There are some additional signals with numbers outside the range 1 through 15 
which are used by the Standard C Library to indicate error conditions. Thus, 
some signal numbers outside the range 1 through 15 are legal, although their 
use may interfere with the operation of the Standard C Library. 
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NAME 

stdio — standard buffered input/output package 

SYNOPSIS 

#include <stdio.h> 

FILE »stdin, *stdout, 'stderr; 

DESCRIPTION 

The functions described in the entries of sub-class 3S of this manual constitute 
an efficient, user-level I/O buffering scheme. The in-line macros getciiS) and 
putc(3S) handle characters quickly. The macros getchar and putchar. and the 
higher-level routines fgetc, /gets, fprintf, fputc\ fputs, fread, fscanf, fwrite, 
gets, getw, print/, puts, putw, and scanf all use or act as if they use getc and 
putc: they can be freely intermixed. 

A file with associated buffering is called a stream and is declared to be a 
pointer to a defined type FILE. FopenOS) creates certain descriptive data for a 
stream and returns a pointer to designate the stream in all further transactions. 
Normally, there are three open streams with constant pointers declared in the 
< stdio. h> header file and associated with the standard open files: 



A constant NULL (0) designates a nonexistent pointer. 

An integer-constant EOF (—1) is returned upon end-of-file or error by most 
integer functions that deal with streams (see the individual descriptions for 
details). 

An integer constant BL'FSIZ specifies the size of the buffers used by the partic- 
ular implementation. 

Any program that uses this package must include the header file of pertinent 
macro definitions, as follows: 

#include <stdio.h> 

The functions and constants mentioned in the entries of sub-class 3S of this 
manual are declared in that header file and need no further declaration. The 
constants and the following "functions" are implemented as macros (redeclara- 
tion of these names is perilous): getc, getchar, putc, putchar. /error, /eo/, 
clearerr, and /ileno. 



open(2), close(2), lseek(2), pipe(2), read(2), write(2), ctermid(3S), 
cuserid(3S), fclose(3S), ferror(3S), fopen(3S), fread(3S), fseek(3S), getc(3S), 
gets(3S), popen(3S), printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), 
system (3S), tmpfile(3S), tmpnam(3S), ungetc(3S). 



Invalid stream pointers will usually cause grave disorder, possibly including 
program termination. Individual function descriptions describe the possible 
error conditions. 



stdin 

stdout 

stderr 



standard input file 
standard output file 
standard error file 



SEE ALSO 



DIAGNOSTICS 
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NAME 

ftok — standard interprocess communication package 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/ipc.h> 

key_t ftok(path, id) 
char *path; 
char id; 

DESCRIPTION 

All interprocess communication facilities require the user to supply a key to be 
used by the msggetil), semgetil), and shmgetil) system calls to obtain inter- 
process communication identifiers. One suggested method for forming a key is 
to use the ftok subroutine described below. Another way to compose keys is to 
include the project ID in the most significant byte and to use the remaining 
portion as a sequence number. There are many other ways to form keys, but it 
is necessary for each system to define standards for forming them. If some 
standard is not adhered to, it will be possible for unrelated processes to uninten- 
tionally interfere with each other's operation. Therefore, it is strongly sug- 
gested that the most significant byte of a key in some sense refer to a project so 
that keys do not conflict across a given system. 

Ftok returns a key based on path and id that is usable in subsequent msgget, 
semget, and shmget system calls. Path must be the path name of an existing 
file that is accessible to the process. Id is a character which uniquely identifies 
a project. Note that ftok will return the same key for linked files when called 
with the same id and that it will return different keys when called with the 
same file name but different ids. 

SEE ALSO 

intro(2), msgget (2), semget (2), shmget (2). 

DIAGNOSTICS 

Ftok returns (key_t) —1 if path does not exist or if it is not accessible to the 
process. 

WARNING 

If the file whose path is passed to ftok is removed when keys still refer to the 
file, future calls to ftok with the same path and id will return an error. If the 
same file is recreated, then ftok is likely to return a different key than it did 
the original time it was called. 
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NAME 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, strrchr, strpbrk, 
strspn, strcspn, strtok — string operations 

SYNOPSIS 

#include <string.h> 

char 'Strcat (si, s2) 
char *sl, *s2; 

char *strncat (si, s2, n) 
char *sl, *s2; 
int n; 

int strcmp (si, s2) 
char *sl, *s2; 

int strncmp (si, s2, n) 
char *sl, *s2; 
int n; 

char *strcpy (si, s2) 
char *sl, *s2; 

char *strncpy (si, s2, n) 
char *sl, *s2; 
int n; 

int strlen (s) 
char *s; 

char *strchr is, c) 
char *s; 
int c; 

char *strrchr (s, c) 
char *s; 
int c; 

char *strpbrk (si, s2) 
char 'sl, •s2; 

int strspn (si, s2) 
char 'sl, *s2; 

int strcspn (si, s2) 
char *sl, *s2; 

char *strtok (si, s2) 
char 'sl, *s2; 

DESCRIPTION 

The arguments si, s2 and s point to strings (arrays of characters terminated by 
a null character). The functions strcat, strncat, strcpy, and strncpy all alter 
si. These functions do not check for overflow of the array pointed to by si. 

Strcat appends a copy of string s2 to the end of string si. Strncat appends at 
most n characters. Each returns a pointer to the null-terminated result. 

Strcmp compares its arguments and returns an integer less than, equal to, or 
greater than 0, according as si is lexicographically less than, equal to, or 
greater than s2. Strncmp makes the same comparison but looks at at most n 
characters. 
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Strcpy copies string s2 to si, stopping after the null character has been copied. 
Strncpy copies exactly n characters, truncating s2 or adding null characters to 
si if necessary. The result will not be null-terminated if the length of s2 is n 
or more. Each function returns si. 

Strlen returns the number of characters in s, not including the terminating null 
character. 

Strchr (strrchr) returns a pointer to the first (last) occurrence of character c in 
string s, or a NULL pointer if c does not occur in the string. The null charac- 
ter terminating a string is considered to be part of the string. 

Strpbrk returns a pointer to the first occurrence in string si of any character 
from string s2, or a NULL pointer if no character from s2 exists in si. 

Strspn istrcspn) returns the length of the initial segment of string si which 
consists entirely of characters from (not from) string s2. 

Strtok considers the string si to consist of a sequence of zero or more text 
tokens separated by spans of one or more characters from the separator string 
s2. The first call (with pointer si specified) returns a pointer to the first char- 
acter of the first token, and will have written a null character into si immedi- 
ately following the returned token. The function keeps track of its position in 
the string between separate calls, so that subsequent calls (which must be made 
with the first argument a NULL pointer) will work through the string si 
immediately following that token. In this way subsequent calls will work 
through the string si until no tokens remain. The separator string s2 may be 
different from call to call. When no token remains in si, a NULL pointer is 
returned. 

NOTE 

For user convenience, all these functions are declared in the optional 
<string.h> header file. 
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NAME 

strtod, atof — convert string to double-precision number 

SYNOPSIS 

double strtod (str, ptr) 
char 'Str, ♦•ptr; 

double atof (str) 
char 'Str; 

DESCRIPTION 

Strtod returns as a double-precision floating-point number the value 
represented by the character string pointed to by str. The string is scanned up 
to the first unrecognized character. 

Strtod recognizes an optional string of "white-space" characters (as defined by 
isspace in ctype{3C)), then an optional sign, then a string of digits optionally 
containing a decimal point, then an optional e or E followed by an optional sign 
or space, followed by an integer. 

If the value of ptr is not (char **)NULL, a pointer to the character terminating 
the scan is returned in the location pointed to by ptr. If no number can be 
formed, *ptr is set to str, and zero is returned. 

Atof(str) is equivalent to strtodCstr, (char **)NULL). 

SEE ALSO 

ctypeOC), scanf(3S), strtolOC). 

DIAGNOSTICS 

If the correct value would cause overflow, ±HUGE is returned (according to the 
sign of the value), and errno is set to ERANGE. 

If the correct value would cause underflow, zero is returned and errno is set to 
ERANGE. 
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NAME 

strtol, atol, atoi — convert string to integer 

SYNOPSIS 

long strtol (str, ptr, base) 
char 'Str, **ptr; 
int base; 

long atol (str) 
char 'Str; 

int atoi (str) 
char 'Str; 

DESCRIPTION 

Strtol returns as a long integer the value represented by the character string 
pointed to by str. The string is scanned up to the first character inconsistent 
with the base. Leading "white-space" characters (as defined by isspace in 
ctypeilO) are ignored. 

If the value of ptr is not (char **)NULL, a pointer to the character terminating 
the scan is returned in the location pointed to by ptr. If no integer can be 
formed, that location is set to str, and zero is returned. 

If base is positive (and not greater than 36), it is used as the base for conver- 
sion. After an optional leading sign, leading zeros are ignored, and "Ox" or 
"OX" is ignored if base is 16. 

If base is zero, the string itself determines the base thusly: After an optional 
leading sign a leading zero indicates octal conversion, and a leading "Ox" or 
"OX" hexadecimal conversion. Otherwise, decimal conversion is used. 

Truncation from long to int can, of course, take place upon assignment or by an 
explicit cast. 

Atol (str) is equivalent to strtol (str, (char **)nuLL, 10). 
Atoi(str) is equivalent to (int) strtoKstr, (char **)null, 10). 

SEE ALSO 

ctypeOC), scanfOS), strtodOC). 

BUGS 

Overflow conditions are ignored. 
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NAME 

swab — swap bytes 

SYNOPSIS 

void swab (from, to, nbytes) 
char *from, •to; 
int nbytes; 

DESCRIPTION 

Swab copies nbytes bytes pointed to by from to the array pointed to by to, 
exchanging adjacent even and odd bytes. It is useful for carrying binary data 
between PDP-lls and other machines. Nbytes should be even and non- 
negative. If nbytes is odd and positive swab uses nbytes— \ instead. If nbytes is 
negative, swab does nothing. 
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NAME 

system — issue a shell command 

SYNOPSIS 

#include <stdio.h> 

int system (string) 
char 'String; 

DESCRIPTION 

System causes the string to be given to sh il) as input, as if the string had 
been typed as a command at a terminal. The current process waits until the 
shell has completed, then returns the exit status of the shell. 

FILES 

/bin/sh 

SEE ALSO 

exec (2). 

sh(l) in the UNIX System User Reference Manual. 
DIAGNOSTICS 

System forks to create a child process that in turn exec's /bin/sh in order to 
execute string. If the fork or exec fails, system returns a negative value and 
sets errno. 
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NAME 

tmpfile — create a temporary file 

SYNOPSIS 

#include <stdio.h> 

FILE *tmpfile 0 

DESCRIPTION 

Tmpfile creates a temporary file using a name generated by tmpnamiiS) , and 
returns a corresponding FILE pointer. If the file cannot be opened, an error 
message is printed using perrori3C), and a NULL pointer is returned. The file 
will automatically be deleted when the process using it terminates. The file is 
opened for update ("w+"). 

SEE ALSO 

creat(2), unlink:(2), fopen(3S), mktemp(3C), perror(3C), tmpnam(3S). 
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NAME 

tmpnam, tempnam — create a name for a temporary file 

SYNOPSIS 

#include <stdio.h> 

char *tinpnam (s) 

char 's; 

char *tempnam (dir, pfx) 

char *dir, *pfx; 

DESCRIPTION 

These functions generate file names that can safely be used for a temporary 
file. 

Tmpnam always generates a file name using the path-prefix defined as 
P_tnipdir in the <stdio.h> header file. If 5 is NULL, tmpnam leaves its result 
in an internal static area and returns a pointer to that area. The next call to 
tmpnam will destroy the contents of the area. If s is not NULL, it is assumed 
to be the address of an array of at least L_tnipnann bytes, where L_tinpnam is a 
constant defined in <stdio.h> \ tmpnam places its result in that array and 
returns s. 

Tempnam allows the user to control the choice of a directory. The argument 
dir points to the name of the directory in which the file is to be created. If dir 
is NULL or points to a string which is not a name for an appropriate directory, 
the path-prefix defined as P_tmpdir in the <stdio.h> header file is used. If 
that directory is not accessible, Amp will be used as a last resort. This entire 
sequence can be up-staged by providing an environment variable TMPDIR in 
the user's environment, whose value is the name of the desired temporary-file 
directory. 

Many applications prefer their temporary files to have certain favorite initial 
letter sequences in their names. Use the pfx argument for this. This argument 
may be NULL or point to a string of up to five characters to be used as the first 
few characters of the temporary-file name. 

Tempnam uses mallocOC) to get space for the constructed file name, and 
returns a pointer to this area. Thus, any pointer value returned from tempnam 
may serve as an argument to free (see mallocOC)) . If tempnam cannot 
return the expected result for any reason, i.e. malloci3C) failed, or none of 
the above mentioned attempts to find an appropriate directory was successful, a 
NULL pointer will be returned. 

NOTES 

These functions generate a different file name each time they are called. 

Files created using these functions and either fopen(3S) or creatil) are tem- 
porary only in the sense that they reside in a directory intended for temporary 
use, and their names are unique. It is the user's responsibility to use unlink (2) 
to remove the file when its use is ended. 

SEE ALSO 

creat(2), unlink(2), fopen(3S), malloc(3C), mktemp(3C), tmpfile(3S). 

BUGS 

If called more than 17,576 times in a single process, these functions will start 
recycling previously used names. 

Between the time a file name is created and the file is opened, it is possible for 
some other process to create a file with the same name. This can never happen 
if that other process is using these functions or mktemp, and the file names are 
chosen so as to render duplication by other means unlikely. 
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NAME 

tsearch, tfind, tdelete, twalk — manage binary search trees 

SYNOPSIS 

#include <search.h> 

char *tsearch ((char *) key, (char ••) rootp, compar) 
int (•compar) ( ); 

char *tfind ((char *) key, (char ••) rootp, compar) 
int (•compar)( ); 

char *tdelete ((char *) key, (char ••) rootp, compar) 
int (♦compar)( ); 

void twaik ((char *) root, action) 
void ('action) ( ); 

DESCRIPTION 

Tsearch, tfind, tdelete, and twalk are routines for manipulating binary search 
trees. They are generalized from Knuth (6.2.2) Algorithms T and D. All com- 
parisons are done with a user-supplied routine. This routine is called with two 
arguments, the pointers to the elements being compared. It returns an integer 
less than, equal to, or greater than 0, according to whether the first argument is 
to be considered less than, equal to or greater than the second argument. The 
comparison function need not compare every byte, so arbitrary data may be 
contained in the elements in addition to the values being compared. 

Tsearch is used to build and access the tree. Key is a pointer to a datum to be 
accessed or stored. If there is a datum in the tree equal to *key (the value 
pointed to by key), a pointer to this found datum is returned. Otherwise, *key 
is inserted, and a pointer to it returned. Only pointers are copied, so the calling 
routine must store the data. Rootp points to a variable that points to the root 
of the tree. A NULL value for the variable pointed to by rootp denotes an 
empty tree; in this case, the variable will be set to point to the datum which 
will be at the root of the new tree. 

Like tsearch, tfind will search for a datum in the tree, returning a pointer to it 
if found. However, if it is not found, tfind will return a NULL pointer. The 
arguments for tfind are the same as for tsearch. 

Tdelete deletes a node from a binary search tree. The arguments are the same 
as for tsearch. The variable pointed to by rootp will be changed if the deleted 
node was the root of the tree. Tdelete returns a pointer to the parent of the 
deleted node, or a NULL pointer if the node is not found. 

Twalk traverses a binary search tree. Root is the root of the tree to be 
traversed. (Any node in a tree may be used as the root for a walk below that 
node.) Action is the name of a routine to be invoked at each node. This rou- 
tine is, in turn, called with three arguments. The first argument is the address 
of the node being visited. The second argument is a value from an enumeration 
data type typedef enum [ preorder, postorder, endorder, leaf ] VISIT; (defined 
in the <search.h> header file), depending on whether this is the first, second 
or third time that the node has been visited (during a depth-first, left-to-right 
traversal of the tree), or whether the node is a leaf. The third argument is the 
level of the node in the tree, with the root being level zero. 

The pointers to the key and the root of the tree should be of type pointer-to- 
element, and cast to type pointer-to-character. Similarly, although declared as 
type pointer-to-character, the value returned should be cast into type pointer- 
to-element. 
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EXAMPLE 

The following code reads in strings and stores structures containing a pointer to 
each string and a count of its length. It then walks the tree, printing out the 
stored strings and their lengths in alphabetical order. 

#include < search. h> 
#include <stdio.h> 



struct node { /* pointers to these are stored in the tree */ 

char *string; 
int length; 

}; 

char string_space[ 10000]; /* space to store strings */ 

struct node nodes[500]; /* nodes to store */ 

struct node *root = NULL; /* this points to the root */ 

main( ) 
{ 

char *strptr = string space; 
struct node *nodeptr = nodes; 
void print_node( ), twalkC ); 
int i = 0, node_compare( ); 

while (gets(strptr) != NULL && i++ < 500) { 
/* set node */ 
nodeptr—> string = strptr; 
nodeptr—> length = strlen (strptr); 
/* put node into the tree */ 
(void) tsearch((char •)nodeptr, &root, 

node_compare) ; 
/♦ adjust pointers, so we don't overwrite tree */ 
strptr += nodeptr— > length + 1; 
nodeptr++; 

} 

twalk(root, print node); 

} 

/* 

This routine compares two nodes, based on an 
alphabetical ordering of the string field. 

*/ 
int 

node compare (node 1 , node2) 
struct node *nodel, •node2; 
{ 

return strcmp(nodel—> string, node2—> string); 

/• 

This routine prints out a node, the first time 
twalk encounters it. 

•/ 
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void 

print_node(node, order, level) 

struct node ♦♦node; 

VISIT order; 

int level; 

{ 

if (order == preorder II order == leaf) { 

(void) printf ("string = %20s, length = %d\n", 
(♦node) — > string, (♦node) — > length) ; 

} 

} 

SEE ALSO 

bsearch(3C), hsearch(3C), lsearch(3C). 

DIAGNOSTICS 

A NULL pointer is returned by tsearch if there is not enough space available to 
create a new node. 

A NULL pointer is returned by tsearch, tfind and tdelete if rootp is NULL on 
entry. 

If the datum is found, both tsearch and tfind return a pointer to it. If not, 
tfind returns NULL, and tsearch returns a pointer to the inserted item. 

WARNINGS 

The root argument to twalk is one level of indirection less than the rootp argu- 
ments to tsearch and tdelete. 

There are two nomenclatures used to refer to the order in which tree nodes are 
visited. Tsearch uses preorder, postorder and endorder to respectively refer to 
visting a node before any of its children, after its left child and before its right, 
and after both its children. The alternate nomenclature uses preorder, inorder 
and postorder to refer to the same visits, which could result in some confusion 
over the meaning of postorder. 

BUGS 

If the calling function alters the pointer to the root, results are unpredictable. 



- 3 - 



TTYNAMEOC) 



TTYNAMEOC) 



NAME 

ttyname, isatty — find name of a terminal 

SYNOPSIS 

char *ttyname (fildes) 
int fildes; 

int isatty (fildes) 
int fildes; 

DESCRIPTION 

Ttyname returns a pointer to a string containing the null-terminated path name 
of the terminal device associated with file descriptor fildes. 

Isatty returns 1 if fildes is associated with a terminal device, 0 otherwise. 

FILES 

/dev/* 
DIAGNOSTICS 

Ttyname returns a NULL pointer if fildes does not describe a terminal device 
in directory /dev. 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

ttyslot — find the slot in the utmp file of the current user 

SYNOPSIS 

int ttyslot ( ) 

DESCRIPTION 

Ttyslot returns the index of the current user's entry in the /etc/utmp file. This 
is accomplished by actually scanning the file /etc/inittab for the name of the 
terminal associated with the standard input, the standard output, or the error 
output (0, 1 or 2). 

FILES 

/etc/inittab 
/etc/utmp 

SEE ALSO 

getut(3C), ttynameOC). 

DIAGNOSTICS 

A value of 0 is returned if an error was encountered while searching for the 
terminal name or if none of the above file descriptors is associated with a termi- 
nal device. 
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NAME 

ungetc — push character back into input stream 

SYNOPSIS 

#include <stdio.h> 

int ungetc (c, stream) 
int c; 

FILE •stream; 
DESCRIPTION 

Ungetc inserts the character c into the buffer associated with an input stream. 
That character, c, will be returned by the next getc(3S) call on that stream. 
Ungetc returns c, and leaves the file stream unchanged. 

One character of pushback is guaranteed, provided something has already been 
read from the stream and the stream is actually buffered. In the case that 
stream is stdin, one character may be pushed back onto the buffer without a 
previous read statement. 

If c equals EOF, ungetc does nothing to the buffer and returns EOF. 

Fseeki3S) erases all memory of inserted characters. 

SEE ALSO 

fseekOS), getcOS), setbufOS). 

DIAGNOSTICS 

Ungetc returns EOF if it cannot insert the character. 
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NAME 

vprintf, vfprintf, vsprintf — print formatted output of a varargs argument list 

SYNOPSIS 

#include <stdio.h> 
#include < varargs.h > 

int vprintf (format, ap) 
char •format; 
vajist ap; 

int vfprintf (stream, format, ap) 
FILE 'Stream; 
char 'format; 
va jist ap; 

int vsprintf (s, format, ap) 
char "s, *format; 
va jist ap; 

DESCRIPTION 

vprintf, vfprintf, and vsprintf are the same as printf, fprintf, and sprintf 
respectively, except that instead of being called with a variable number of argu- 
ments, they are called with an argument list as defined by varargs (5) . 

EXAMPLE 

The following demonstrates how vfprintf could be used to write an error rou- 
tine. 

#include <stdio.h> 
#include < varargs.h > 



/* 

* error should be called like 

* error (function_name, format, argl, arg2...); 
*/ 

/*VARARGSO*/ 
void 

error (vaalist) 

/* Note that the function name and format arguments cannot be 

* separately declared because of the definition of varargs. 
*/ 

vadcl 
{ 

vajist args; 
char *fmt; 

va_start(args); 

/* print out name of function causing error •/ 

(void) fprintf (stderr, "ERROR in %s: ", va_arg(args, char *)); 

fmt = va_arg(args, char *); 

/* print out remainder of message */ 

(void) vfprintf (fmt, args); 

va_end(args); 

(void) abort ( ); 

} 

SEE ALSO 

vprintf (3X), varargs (5). 
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NAME 

jO, jl, jn, yO, yl, yn — Bessel functions 

SYNOPSIS 

#inciude <math.h> 

double jO (x) 
double x; 

double jl (x) 
double x; 

double jn (n, x) 
int n; 
double x; 

double yO (x) 
double x; 

double yl (x) 
double x; 

double yn (n, x) 
int n; 
double x; 

DESCRIPTION 

JO and jl return Bessel functions of x of the first kind of orders 0 and 1 
respectively. Jn returns the Bessel function of x of the first kind of order n. 

YO and yl return Bessel functions of x of the second kind of orders 0 and 1 
respectively. Yn returns the Bessel function of x of the second kind of order n. 
The value of x must be positive. 

DIAGNOSTICS 

Non-positive arguments cause yO, yl and yn to return the value -HUGE and to 
set errno to EDOM. In addition, a message indicating DOMAIN error is printed 
on the standard error output. 

Arguments too large in magnitude cause jO, jl , yO and yl to return zero and to 
set errno to ERANGE. In addition, a message indicating TLOSS error is printed 
on the standard error output. 

These error-handling procedures may be changed with the function 
matherr (3M) . 

SEE ALSO 

matherr(3M). 
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NAME 



erf, erfc — error function and complementary error function 

SYNOPSIS 

#include <math.h> 

double erf (x) 
double x; 

double erfc (x) 
double x; 

DESCRIPTION 



Erf returns the error function of x, defined as —j=rje ''dt. 

VTT 0 

Erfc, which returns 1.0 — erf(x), is provided because of the extreme loss of 
relative accuracy if erf(x) is called for large x and the result subtracted from 
1.0 (e.g., for X = 5, 12 places are lost). 



X 




SEE ALSO 



exp(3M). 
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NAME 

exp, log, loglO, pow, sqrt — exponential, logarithm, power, square root functions 

SYNOPSIS 

#include <math.h> 

double exp (x) 
double x; 

double log (x) 
double x; 

double loglO (x) 
double x; 

double pow (x, y) 
double X, y; 

double sqrt (x) 
double x; 

DESCRIPTION 

Exp returns . 

Log returns the natural logarithm of x. The value of x must be positive. 

LoglO returns the logarithm base ten of x. The value of x must be positive. 

Pow returns . If x is zero, y must be positive. If x is negative, y must be an 
integer. 

Sqrt returns the non-negative square root of x. The value of x may not be 
negative. 

DIAGNOSTICS 

Exp returns HUGE when the correct value would overflow, or 0 when the 
correct value would underflow, and sets errno to ERANGE. 

Log and loglO return -HUGE and set errno to EDOM when x is non-positive. 
A message indicating DOMAIN error (or SING error when x is 0) is printed on 
the standard error output. 

Pow returns 0 and sets errno to EDOM when x is 0 and y is non-positive, or 
when X is negative and y is not an integer. In these cases a message indicating 
DOMAIN error is printed on the standard error output. When the correct value 
for pow would overflow or underflow, pow returns ±HUGE or 0 respectively, 
and sets errno to ERANGE. 

Sqrt returns 0 and sets errno to EDOM when x is negative. A message indicat- 
ing DOMAIN error is printed on the standard error output. 

These error-handling procedures may be changed with the function 
matherriZM) . 

SEE ALSO 

hypotOM), matherr(3M), sinh(3M). 
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NAME 

floor, ceil, fmod, fabs — floor, ceiling, remainder, absolute value functions 

SYNOPSIS 

#include <math.h> 

double floor (x) 
double x; 

double ceil (x) 
double x; 

double fmod (x, y) 
double X, y; 

double fabs (x) 
double x; 

DESCRIPTION 

Floor returns the largest integer (as a double-precision number) not greater 
than X. 

Ceil returns the smallest integer not less than x. 

Fmod returns the floating-point remainder of the division of x by y: zero if y is 
zero or if x/y would overflow; otherwise the number / with the same sign as x, 
such that x — iy f for some integer /, and \f\ < \y\. 

Fabs returns the absolute value of x, \x\. 

SEE ALSO 

abs(3C). 
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NAME 

gamma — log gamma function 

SYNOPSIS 

#inciude <math.h> 

double gamma (x) 
double x; 

extern int signgam; 
DESCRIPTION 

Gamma returns ln(|r(x)|), where T{x) is defined as Je~'t'^~^dt. The sign of 

0 

r(x) is returned in the external integer signgam. The argument x may not be 
a non-positive integer. 

The following C program fragment might be used to calculate F: 

if ((y = gamma (x)) > LN_MAXD0UBLE) 

errorO; 
y = signgam * exp(y); 

where LN MAXDOUBLE is the least value that causes exp(3M) to return a 
range error, and is defined in the <values.h> header file. 

DIAGNOSTICS 

For non-negative integer arguments HUGE is returned, and errno is set to 
EDOM. A message indicating SING error is printed on the standard error out- 
put. 

If the correct value would overflow, gamma returns HUGE and sets errno to 

erange. 

These error-handling procedures may be changed with the function 
matherr (3M) . 

SEE ALSO 

exp(3M), matherr(3M), values(5). 
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NAME 

hypot — Euclidean distance function 

SYNOPSIS 

#include <math,h> 

double hypot (x, y) 
double X, y; 

DESCRIPTION 

Hypot returns 

sqrt(x * X + y * y), 
taking precautions against unwarranted overflows. 
DIAGNOSTICS 

When the correct value would overflow, hypot returns HUGE and sets errno to 
ERANGE. 

These error-handling procedures may be changed with the function 
matherrOiM) . 

SEE ALSO 

matherr(3M). 
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NAME 

matherr — error-handling function " 

SYNOPSIS 

#include <math.h> 

int matherr (x) 
struct exception 'x; 

DESCRIPTION 

Matherr is invoked by functions in the Math Library when errors are detected. 
Users may define their own procedures for handling errors, by including a func- 
tion named matherr in their programs. Matherr must be of the form described 
above. When an error occurs, a pointer to the exception structure x will be 
passed to the user-supplied matherr function. This structure, which is defined 
in the <math.h> header file, is as follows: 

struct exception { 
int type; 
char *name; 

double argl, arg2, retval; 

}; 

The element type is an integer describing the type of error that has occurred, 
from the following list of constants (defined in the header file): 

DOMAIN argument domain error 

SING argument singularity 

OVERFLOW overflow range error 

UNDERFLOW underflow range error 

TLOSS total loss of significance 

PLOSS partial loss of significance 

The element name points to a string containing the name of the function that 
incurred the error. The variables argl and arg2 are the arguments with which 
the function was invoked. Retval is set to the default value that will be 
returned by the function unless the user's matherr sets it to a diff'erent value. 

If the user's matherr function returns non-zero, no error message will be 
printed, and errno will not be set. 

If matherr is not supplied by the user, the default error-handling procedures, 
described with the math functions involved, will be invoked upon error. These 
procedures are also summarized in the table below. In every case, errno is set 
to EDOM or ERANGE and the program continues. 

EXAMPLE 

#include <math.h> 



int 

matherr (x) 

register struct exception ♦x; 
{ 

switch (x— >type) { 
case DOMAIN: 

/* change sqrt to return sqrt(— argl), not 0 */ 
if (!strcmp(x— >name, "sqrt")) { 

x—> retval == sqrt(— x— >argl): 

return (0); /* print message and set errno */ 

case SING: 

/* all other domain or sing errors, print message and abort */ 
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fprintf(stderr, "domain error in %s\n", x— >name); 
abort ( ); 
case PLOSS: 

/* print detailed error message */ 

fprintf(stderr, "loss of significance in %s(%g) = %g\n", 

X— >name, x— >argl, x— >retval); 
return (l); /* take no other action */ 

} 

return (0); /* all other errors, execute default procedure */ 



DEFAULT ERROR HANDLING PROCEDURES 




Types of Errors 


type 


DOMAIN 


SING 


OVERFLOW 


UNDERFLOW 


TLOSS 


PLOSS 


errno 


EDOM 


EDOM 


ERANGE 


ERANGE 


ERANGE 


ERANGE 


BESSEL: 


- 


- 


- 


- 


M, 0 




yO, y 1, yn (arg < 0) 


M, -H 












EXP: 






H 


0 






LOG, LOG 10: 














(arg < 0) 


M, -H 












(arg - 0) 




M, -H 










POW: 






±H 


0 






neg non-int 


M, 0 












0 non-pos 














SQRT: 


M, 0 












GAMMA: 




M, H 


H 








HYPOT: 






H 








SINH: 






±H 








COSH: 






H 








SIN, cos, TAN: - 








M, 0 






ASIN, ACQS, ATAN2: M, 0 

















ABBREVIATIONS 




As much as possible of the value is returned. 


M 


Message is printed (EDOM error). 


H 


HUGE is returned. 


-H 


—HUGE is returned. 


±H 


HUGE or —HUGE is returned. 


0 


0 is returned. 
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NAME 

sinh, cosh, tanh — hyperbolic functions 

SYNOPSIS 

#include <math.h> 

double sinh (x) 
double x; 

double cosh (x) 
double x; 

double tanh (x) 
double x; 

DESCRIPTION 

Sinh, cosh, and tanh return, respectively, the hyberbolic sine, cosine and 
tangent of their argument. 

DIAGNOSTICS 

Sinh and cosh return HUGE (and sinh may return -HUGE for negative x) 
when the correct value would overflow and set errno to ERANGE. 

These error-handling procedures may be changed with the function 
niatherr(3M) . 

SEE ALSO 

matherr(3M). 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 — trigonometric functions 

SYNOPSIS 

#include <math.h> 





sin (x) 


double 


x; 




pnc (v) 


double 


x; 


uuuuic 




double 


x; 


double 


asin (x) 


double 


x; 


double 


acos (x) 


double 


x; 


double 


atan (x) 


double 


x; 


double 


atan2 (y. 


double 


y, x; 


DESCRIPTION 



Sin, cos and tan return respectively the sine, cosine and tangent of their argu- 
ment, X, measured in radians. 

Asin returns the arcsine of x, in the range —ir/l to 7r/2. 

Acos returns the arccosine of x, in the range 0 to tt. 

Atan returns the arctangent of x, in the range —k/1 to 7r/2. 

Atan2 returns the arctangent of y/x, in the range —tt to tt, using the signs of 
both arguments to determine the quadrant of the return value. 

DIAGNOSTICS 

Sin, cos, and tan lose accuracy when their argument is far from zero. For 
arguments sufficiently large, these functions return zero when there would oth- 
erwise be a complete loss of significance. In this case a message indicating 
TLOSS error is printed on the standard error output. For less extreme argu- 
ments causing partial loss of significance, a PLOSS error is generated but no 
message is printed. In both cases, errno is set to ERANGE. 

If the magnitude of the argument of asin or acos is greater than one, or if both 
arguments of atan2 are zero, zero is returned and errno is set to EDOM. In 
addition, a message indicating DOMAIN error is printed on the standard error 
output. 

These error-handling procedures may be changed with the function 
mat herr (3M) . 

SEE ALSO 

matherr(3M). 
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NAME 

assert — verify program assertion 

SYNOPSIS 

#include <assert.h> 

assert (expression) 
int expression; 

DESCRIPTION 

This macro is useful for putting diagnostics into programs. When it is exe- 
cuted, if expression is false (zero), assert prints 

"Assertion failed: expression, file xyz, line H«n" 

on the standard error output and aborts. In the error message, xyz is the name 
of the source file and nnn the source line number of the assert statement. 

Compiling with the preprocessor option -DNDEBUG (see cpp{\)), or with the 
preprocessor control statement "#define N DEBUG'" ahead of the "#include 
<assert.h>" statement, will stop assertions from being compiled into the pro- 
gram. 

SEE ALSO 

abortOC). 

cpp(l) in the UNIX System V User Reference Manual. 
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NAME 



curses — CRT screen handling and optimization package 



SYNOPSIS 



#include <curses.h> 

cc [ flags ] files — Icurses [ libraries ] 



DESCRIPTION 



These routines give the user a method of updating screens with reasonable 
optimization. In order to initialize the routines, the routine initscrO must be 
called before any of the other routines that deal with windows and screens are 
used. The routine endwinO should be called before exiting. To get character- 
at-a-time input without echoing, (most interactive, screen oriented-programs 
want this) after calling initscrO you should call "nonlO; cbreakO; noechoO;" 

The full curses interface permits manipulation of data structures called win- 
dows which can be thought of as two dimensional arrays of characters 
representing all or part of a CRT screen. A default window called stdscr is sup- 
plied, and others can be created with newwin. Windows are referred to by vari- 
ables declared "WINDOW *", the type WINDOW is defined in curses. h to be a 
C structure. These data structures are manipulated with functions described 
below, among which the most basic are move, and addch. (More general ver- 
sions of these functions are included with names beginning with 'w', allowing 
you to specify a window. The routines not beginning with 'w' affect stdscr.) 
Then refreshO is called, telling the routines to make the users CRT screen look 
like stdscr. 

Mini-Curses is a subset of curses which does not allow manipulation of more 
than one window. To invoke this subset, use -DMINICURSES as a cc option. 
This level is smaller and faster than full curses. 

If the environment variable TERMINFO is defined, any program using curses 
will check for a local terminal definition before checking in the standard place. 
For example, if the standard place is /usr/lib/terminfo, and TERM is set to 
"vtlOO", then normally the compiled file is found in /usr/lib/terminfo/v/vtlOO. 
(The "v" is copied from the first letter of "vtlOO" to avoid creation of huge 
directories.) However, if TERMINFO is set to /usr/mark/my terms, curses will 
first check /opusr/mark/myterms/v/vtlOO, and if that fails, will then check 
/usr/lib/terminfo/v/vtlOO. This is useful for developing experimental 
definitions or when write permission in /usr/lib/terminfo is not available. 



Routines listed here may be called when using the full curses. Those marked 
with an asterisk may be called when using Mini-Curses. 



SEE ALSO 



terminfo(4). 



FUNCTIONS 



addch (ch)* 



add a character to stdscr (like putchar) 

(wraps to next line at end of line) 

calls addch with each character in str 

turn off attributes named 

turn on attributes named 

set current attributes to attrs 

current terminal speed 

sound beep on terminal 

draw a box around edges of win 

vert and hor are chars to use for vert, and 

hor. edges of box 

clear stdscr 

clear screen before next redraw of win 



addstr(str)* 
attroff(attrs)* 
attron (attrs) * 
attrset (attrs)* 
baudrateO* 
beepO* 



box (win, vert, hor) 



clear 0 

clearok(win, bf) 
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clrtobotO 

clrtoeolO 

cbreakO* 

delay_output(ms) * 

delchO 

deletelnO 

delwin(win) 

doupdateO 

echoO* 

endwinO* 

eraseO 

erasecharO 

fixtermO 

flashO 

flushinpO* 

getchO* 

getstr(str) 

gettmodeO 

getyxCwin, y, x) 

hasjcO 

hasjlO 

idlok(win, bf)* 

inchO 

initscrO* 

insch(c) 

insertlnO 

intrflush(win, bf) 

keypad(win, bf) 

killcharO 

leaveok(win, flag) 



longnameO 
meta(win, flag)* 
move(y, x)* 
mvaddchCy, x, ch) 
mvaddstr(y, x, str) 



clear to bottom of stdscr 
clear to end of line on stdscr 
set cbreak mode 

insert ms millisecond pause in output 
delete a character 
delete a line 
delete win 

update screen from all wnooutrefresh 
set echo mode 
end window modes 
erase stdscr 

return user's erase character 

restore tty to "in curses" state 

flash screen or beep 

throw away any typeahead 

get a char from tty 

get a string through stdscr 

establish current tty modes 

get (y, x) co-ordinates 

true if terminal can do insert character 

true if terminal can do insert line 

use terminal's insert/delete line if bf != 0 

get char at current (y, x) co-ordinates 

initialize screens 

insert a char 

insert a line 

interrupts flush output if bf is TRUE 

enable keypad input 

return current user's kill character 

OK to leave cursor anywhere after refresh if 

flag!=0 for win, otherwise cursor must be left 

at current position. 

return verbose name of terminal 

allow meta characters on input if flag != 0 

move to (y, x) on stdscr 

move(y, x) then addch(ch) 

similar... 



mvcur(oldrow, oldcol, newrow, newcoDlow level cursor motion 



mvdelch(y, x) 
mvgetchCy, x) 
mvgetstr(y, x) 
mvinch(y, x) 
mvinsch(y, x, c) 
mvprintw(y, x, fmt, args) 
mvscanw(y, x, fmt, args) 
mvwaddch(win, y, x, ch) 
mvwaddstr(win, y, x, str) 
mvwdelch(win, y, x) 
mvwgetch(win, y, x) 
mvwgetstr(win, y. x) 
mvwin(win, by, bx) 
mvwinch(win, y, x) 
mvwinsch(win, y, x, c) 
mvwprintw(win, y, x, fmt, args) 
mvwscanw(win, y, x, fmt, args) 



like delch, but move(y, x) first 
etc. 



newpad(nlines, ncols) 
newtermCtype, fd) 



create a new pad with given dimensions 

set up new terminal of given type to output on fd 
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newwindines, cols, begin_y, begin_x) create a new window 



niO* 

nocbreakO* 
nodelayCwin, bf) 
noechoO* 
nonlO* 
norawO* 

overlay(winl, win2) 
overwrite(winl, win2) 



set newline mapping 
unset cbreak mode 

enable nodelay input mode through getch 
unset echo mode 
unset newline mapping 
unset raw mode 
overlay winl on win2 
overwrite winl on top of winl 
pnoutrefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 

like prefresh but with no output until doupdate called 
prefresh(pad, pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol) 

refresh from pad starting with given upper left corner of pad 
with output to given portion of screen 
printf on stdscr 
set raw mode 

make current screen look like stdscr 
set tty modes to "out of curses" state 
reset tty flags to stored value 
save current modes as "in curses" state 
store current tty flags 
scanf through stdscr 
scroll win one line 
allow terminal to scroll if flag != 0 
now talk to terminal new 
set user scrolling region to lines t through b 
establish terminal with given type 



printw(fmt, argl, arg2, ...) 

rawO* 

refresh 0* 

resettermO* 

resettyO* 

savetermO* 

savettyO* 

scanw(fmt, argl, arg2, ...) 
scroll (win) 
scrollok(win, flag) 
set_term(new) 
setscrregd, b) 
setterm (type) 



setupterm(term, filenum, errret) 

standendO* clear standout mode attribute 

standoutO* set standout mode attribute 

subwin(win, lines, cols, begin_y, begin_x) create a subwindow 



touchwin(win) 
traceofi" 0 
traceonO 
typeahead(fd) 
unctrl(ch)* 
waddch(win, ch) 
waddstr(win, str) 
wattroff (win, attrs) 
wattron(win, attrs) 
wattrset(win, attrs) 
wclear(win) 
wclrtobot(win) 
wclrtoeol(win) 
wdelch(win, c) 
wdeleteln(win) 
werase(win) 
wgetch(win) 
wgetstr(win, str) 
winch (win) 
winsch(win, c) 
winsertln(win) 
wmove(win, y, x) 
wnoutrefresh(win) 



change all of win 

turn off" debugging trace output 

turn on debugging trace output 

use file descriptor fd to check typeahead 

printable version of ch 

add char to win 

add string to win 

turn off" attrs in win 

turn on attrs in win 

set attrs in win to attrs 

clear win 

clear to bottom of win 
clear to end of line on win 
delete char from win 
delete line from win 
erase win 

get a char through win 

get a string through win 

get char at current (y, x) in win 

insert char into win 

insert line into win 

set current (y, x) co-ordinates on win 
refresh but no screen output 



wprintw(win, fmt, argl, arg2, ...) printf on win 
wrefresh(win) make screen look like win 

wscanw(win, fmt, argl, arg2, ...) scanf through win 
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wsetscrreg(win, t, b) 

wstandend(win) 

wstandout(win) 



set scrolling region of win 
clear standout attribute in win 
set standout attribute in win 



TERMINFO LEVEL ROUTINES 

These routines should be called by programs wishing to deal directly with the 
terminfo database. Due to the low level of this interface, it is discouraged. Ini- 
tially, setupterm should be called. This will define the set of terminal depen- 
dent variables defined in terminfo(4). The include files <curses.h> and 
<term.h> should be included to get the definitions for these strings, numbers, 
and flags. Parmeterized strings should be passed through tparm to instantiate 
them. All terminfo strings (including the output of tparm) should be printed 
with tputs or putp . Before exiting, resetterm should be called to restore the tty 
modes. (Programs desiring shell escapes or suspending with control Z can call 
resetterm before the shell is called and fixterm after returning from the shell.) 



fixtermO 
resetterm 0 

setupterm (term, fd, rc) 



restore tty modes for terminfo use 
(called by setupterm) 

reset tty modes to state before program entry 
read in database. Terminal type is the 
character string term, all output is to UNIX System file 
descriptor fd. A status value is returned in the 
integer pointed to by rc. 1 is normal. The simplest 
call would be setupterm(0, I, 0) which uses all the defaults, 
instantiate string str with parms pj. 
apply padding info to string str. 
ajfcnt is the number of lines affected, or 1 if 
not applicable. Putc is a putchar-like function 
to which the characters are passed, one at a time, 
handy function that calls tputs(str, 1, putchar). 
output the string to put terminal in video attribute 
mode attrs, which is any combination of the attributes 
listed below. Chars are passed to putchar-like function putc. 
Like vidputs but outputs through putchar 

TERMCAP COMPATIBILITY ROUTINES 

These routines were included as a conversion aid for programs that use 
termcap. Their parameters are the same as for termcap. They are emulated 
using the terminfo database. They may go away at a later date. 



tparm(str, pi, p2, p9) 
tputs(str, affcnt, putc) 



putp(str) 

vidputs(attrs, putc) 



vidattr(attrs) 



tgetent(bp, name) 
tgetflag(id) 
tgetnum(id) 
tgetstrdd, area) 
tgoto(cap, col, row) 
tputs (cap, affcnt, fn) 

ATTRIBUTES 

The following video 

attron,attroff,attrset . 

ASTANDOUT 

A_UNDERLINE 

A_REVERSE 

ABLINK 

A_DIM 

A_BOLD 

ABLANK 

A PROTECT 

A ALTCHARSET 



look up termcap entry for name 

get boolean entry for id 

get numeric entry for id 

get string entry for id 

apply parms to given cap 

apply padding to cap calling fn as putchar 

attributes can be passed to the functions 

Terminal's best highlighting mode 

Underlining 

Reverse video 

Blinking 

Half bright 

Extra bright or bold 

Blanking (invisible) 

Protected 

Alternate character set 
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FUNCTION KEYS 

The following function keys might be returned by getch if keypad has been 
enabled. Note that not all of these are currently supported, due to lack of 
definitions in terminfo or the terminal not transmitting a unique code when the 
key is pressed. 



Name 


Value 


Key name 


KEYBREAK 


0401 


break key (unreliable) 


KEY_DOWN 


0402 


The four arrow keys ... 


KEY_UP 


0403 




KEYLEFT 


0404 




KEY_RIGHT 


0405 




KEY_HOME 


0406 


Home key (upward+left arrow) 


KEY_BACKSPACE 


0407 


backspace (unreliable) 


KEYFO 


0410 


Function keys. Space for 64 is reserved 


KEY F(n) 


(KEY_F0+(n)) 


Formula for fn. 


keyIdl 


0510 


Delete line 


KEY IL 


0511 


Insert line 


KEYDC 


0512 


Delete character 


KEYJC 


0513 


Insert char or enter insert mode 


KEY_EIC 


0514 


Exit insert char mode 


KEY_CLEAR 


0515 


Clear screen 


KEY_EOS 


0516 


Clear to end of screen 


KEY_EOL 


0517 


Clear to end of line 


KEY_SF 


0520 


Scroll 1 line forward 


KEY_SR 


0521 


Scroll 1 line backwards (reverse) 


KEY NPAGE 


0522 


Next page 


KEY_PPAGE 


0523 


Previous page 


KEY_STAB 


0524 


Set tab 


KEY_CTAB 


0525 


Clear tab 


KEY_CATAB 


0526 


Clear all tabs 


KEY_ENTER 


0527 


Enter or send (unreliable) 


KEY_SRESET 


0530 


soft (partial) reset (unreliable) 


KEY_RESET 


0531 


reset or hard reset (unreliable) 


KEY_PR1NT 


0532 


print or copy 


KEY_LL 


0533 


home down or bottom (lower left) 



WARNING 

The plotting library plotilX) and the curses library curses (3X) both use the 
names eraseO and moveO. The curses versions are macros. If you need both 
libraries, put the plotiiX) code in a different source file than the curses (3X) 
code, and/or #undef moveO and eraseO in the plot{3X) code. 
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NAME 

Idahread — read the archive header of a member of an archive file 

SYNOPSIS 

#include <stdio.h> 
#include <ar.h> 
#include <filehdr.h> 
#include <ldfcn.h> 

int Idahread (Idptr, arhead) 
LDFILE 'Idptr; 
ARCHDR «arhead; 

DESCRIPTION 

If T\PEUdptr) is the archive file magic number, Idahread reads the archive 
header of the common object file currently associated with Idptr into the area 
of memory beginning at arhead. 

Ldahread returns SUCCESS or FAILURE. Ldahread will fail if TYPE(Wp//-) 
does not represent an archive file, or if it cannot read the archive header. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

IdcloseOX), IdopenOX), ldfcn(4), ar(4). 



- 1 - 



LDCLOSEOX) 



LDCLOSEOX) 



NAME 

Idclose, Idaclose — close a common object file 

SYNOPSIS 

#inciude <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int Idclose (Idptr) 
LDFILE 'Idptr; 

int Idaclose (Idptr) 
LDFILE 'Idptr; 

DESCRIPTION 

LdopeniSX) and Idclose are designed to provide uniform access to both simple 
object files and object files that are members of archive files. Thus an archive 
of common object files can be processed as if it were a series of simple common 
object files. 

If T\PE(ldptr) does not represent an archive file, Idclose will close the file and 
free the memory allocated to the LDFILE structure associated with Idptr. If 
JYPEildptr) is the magic number of an archive file, and if there are any more 
files in the archive, Idclose will reinitialize OFFSElUdptr) to the file address of 
the next archive member and return FAILURE. The LDFILE structure is 
prepared for a subsequent ldopen(3X) . In all other cases, Idclose returns SUC- 
CESS. 

Ldaclose closes the file and frees the memory allocated to the LDFILE structure 
associated with Idptr regardless of the value of TYPE(ldptr). Ldaclose always 
returns SUCCESS. The function is often used in conjunction with Idaopen. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

fcloseOS), IdopenOX), ldfcn(4). 
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NAME 

Idfhread — read the file header of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int Idfhread (Idptr, filehead) 
LDFILE •Idptr; 
FILHDR *filehead; 

DESCRIPTION 

Ldfhread reads the file header of the common object file currently associated 
with Idptr into the area of memory beginning at filehead. 

Ldfhread returns SUCCESS or FAILURE. Ldfhread will fail if it cannot read 
the file header. 

In most cases the use of Idfhread can be avoided by using the macro 
HEADER(Wprr) defined in Idfcn.h (see Idfcn (4)). The information in any 
field, fieldname, of the file header may be accessed using 
HEADER (Idptr) .fieldname. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), IdopenOX), ldfcn(4). 
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NAME 

Idgetname — retrieve symbol name for common object file symbol table entry 

SYNOPSIS 

#include <stdio.h> 

#inclucle <filehdr.h> 

#include <syms.h> 

#include <ldfcn.h> 

char *ldgetname (Idptr, symbol) 
LDFILE ♦Idptr; 
SYMENT *synibol; 

DESCRIPTION 

Ldgetname returns a pointer to the name associated with symbol as a string. 
The string is contained in a static buffer local to Idgetname that is overwritten 
by each call to Idgetname, and therefore must be copied by the caller if the 
name is to be saved. 

As of UNIX system release 5.0, the common object file format has been 
extended to handle arbitrary length symbol names with the addition of a 
"string table". Ldgetname will return the symbol name associated with a sym- 
bol table entry for either a pre-UNIX system 5.0 object file or a UNIX system 
5.0 object file. Thus, Idgetname can be used to retrieve names from object files 
without any backward compatibility problems. Ldgetname will return NULL 
(defined in stdio.h) for a UNIX system 5.0 object file if the name cannot be 
retrieved. This situation can occur: 

— if the "string table" cannot be found, 

— if not enough memory can be allocated for the string table, 

— if the string table appears not to be a string table (for example, if an 
auxiliary entry is handed to Idgetname that looks like a reference to a 
name in a non-existent string table), or 

— if the name's offset into the string table is past the end of the string 
table. 

Typically, Idgetname will be called immediately after a successful call to 
Idtbread to retrieve the name associated with the symbol table entry filled by 
Idt bread. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

IdcloseOX), IdopenOX), Idtbread (3X), IdtbseekOX), ldfcn(4). 
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NAME 

Idlread, Idlinit, Idlitem — manipulate line number entries of a common object 
file function 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <linenum.h> 
#include <ldfcn.h> 

int Idlread (Idptr, fcnindx, linenum, linent) 

LDFILE •Idptr; 

long fcnindx; 

unsigned short linenum; 

LINENO linent; 

int Idlinitddptr, fcnindx) 
LDFILE ♦Idptr; 
long fcnindx; 

int Idlitem (Idptr, linenum, linent) 
LDFILE *Idptr; 
unsigned short linenum; 
LINENO linent; 

DESCRIPTION 

Ldlread searches the line number entries of the common object file currently 
associated with Idptr. Ldlread begins its search with the line number entry for 
the beginning of a function and confines its search to the line numbers associ- 
ated with a single function. The function is identified hy fcnindx, the index of 
its entry in the object file symbol table. Ldlread reads the entry with the smal- 
lest line number equal to or greater than linenum into linent. 

Ldlinit and Idlitem together perform exactly the same function as Idlread. 
After an initial call to Idlread or Idlinit, Idlitem may be used to retrieve a 
series of line number entries associated with a single function. Ldlinit simply 
locates the line number entries for the function identified by fcnindx. Ldlitem 
finds and reads the entry with the smallest line number equal to or greater than 
linenum into linent. 

Ldlread, Idlinit, and Idlitem each return either SUCCESS or FAILURE. 
Ldlread will fail if there are no line number entries in the object file, if fcnindx 
does not index a function entry in the symbol table, or if it finds no line number 
equal to or greater than linenum. Ldlinit will fail if there are no line number 
entries in the object file or if fcnindx does not index a function entry in the 
symbol table. Ldlitem will fail if it finds no line number equal to or greater 
than linenum. 

The programs must be loaded with the object file access routine library Iibld.a. 
SEE ALSO 

IdcloseOX), IdopenOX), IdtbindexOX), ldfcn(4). 
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NAME 

Idlseek, Idnlseek — seek to line number entries of a section of a common object 
file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int Idlseek (Idptr, sectindx) 
LDFILE -Idptr; 
unsigned short sectindx; 

int Idnlseek (Idptr, sectname) 
LDFILE -Idptr; 
char *sectname; 

DESCRIPTION 

Ldlseek seeks to the line number entries of the section specified by sectindx of 
the common object file currently associated with Idptr. 

Ldnlseek seeks to the line number entries of the section specified by sectname. 

Ldlseek and Idnlseek return SUCCESS or FAILURE. Ldlseek will fail if sec- 
tindx is greater than the number of sections in the object file; Idnlseek will fail 
if there is no section name corresponding with *sectname. Either function will 
fail if the specified section has no line number entries or if it cannot seek to the 
specified line number entries. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

IdcloseOX), IdopenOX), IdshreadOX), ldfcn(4). 
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NAME 

Idohseek — seek to the optional file header of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int Idohseek (Idptr) 
LDFILE 'Idptr; 

DESCRIPTION 

Ldohseek seeks to the optional file header of the common object file currently 
associated with Idptr. 

Ldohseek returns SUCCESS or FAILURE. Ldohseek will fail if the object file 
has no optional header or if it cannot seek to the optional header. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

IdcloseOX), ldopen(3X), IdfhreadOX), ldfcn(4). 
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NAME 

Idopen, Idaopen — open a common object file for reading 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

LDFILE *ldopen (filename, Idptr) 
char 'filename; 
LDFILE »ldptr; 

LDFILE *ldaopen (filename, oldptr)' 
char 'filename; 
LDFILE 'oldptr; 

DESCRIPTION 

Ldopen and ldclose(3X) are designed to provide uniform access to both simple 
object files and object files that are members of archive files. Thus an archive 
of common object files can be processed as if it were a series of simple common 
object files. 

If Idptr has the value NULL, then Idopen will open filename and allocate and 
initialize the LDFILE structure, and return a pointer to the structure to the cal- 
ling program. 

If Idptr is valid and if TYPEildptr) is the archive magic number, Idopen will 
reinitialize the LDFILE structure for the next archive member of filename. 

Ldopen and ldclose(3X) are designed to work in concert. Ldclose will return 
FAILURE only when T\PEildptr) is the archive magic number and there is 
another file in the archive to be processed. Only then should Idopen be called 
with the current value of Idptr. In all other cases, in particular whenever a 
new filename is opened, Idopen should be called with a NULL Idptr argument. 

The following is a prototype for the use of Idopen and ldclose(3X). 

/* for each filename to be processed */ 

Idptr = NULL; 

do 

{ 

if ( (Idptr = Idopen (filename, Idptr)) != NULL ) 
{ 

/* check magic number */ 
/* process the file */ 

} 

} while (ldclose (Idptr) === FAILURE ); 

If the value of oldptr is not NULL, Idaopen will open filename anew and allo- 
cate and initialize a new LDFILE structure, copying the TYPE, OFFSET, and 
HEADER fields from oldptr. Ldaopen returns a pointer to the new LDFILE 
structure. This new pointer is independent of the old pointer, oldptr. The two 
pointers may be used concurrently to read separate parts of the object file. For 
example, one pointer may be used to step sequentially through the relocation 
information, while the other is used to read indexed symbol table entries. 



- 1 - 



LDOPENOX) 



LDOPENOX) 



Both Idopen and Idaopen open filename for reading. Both functions return 
NULL if filename cannot be opened, or if memory for the LDFILE structure 
cannot be allocated. A successful open does not insure that the given file is a 
common object file or an archived object file. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

fopenOS), ldclose(3X), ldfcn(4). 
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NAME 

Idrseek, Idnrseek — seek to relocation entries of a section of a common object 
file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <ldfcn.h> 

int Idrseek (Idptr, sectindx) 
LDFILE •Idptr; 
unsigned short sectindx; 

int Idnrseek (Idptr, sectname) 
LDFILE •Idptr; 
char •sectname; 

DESCRIPTION 

Ldrseek seeks to the relocation entries of the section specified by sectindx of 
the common object file currently associated with Idptr. 

Ldnrseek seeks to the relocation entries of the section specified by sectname. 

Ldrseek and Idnrseek return SUCCESS or FAILURE. Ldrseek will fail if sec- 
tindx is greater than the number of sections in the object file; Idnrseek will fail 
if there is no section name corresponding with sectname. Either function will 
fail if the specified section has no relocation entries or if it cannot seek to the 
specified relocation entries. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

IdcloseOX), IdopenOX), IdshreadOX), ldfcn(4). 
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NAME 

Idshread, Jdnshread — read an indexed/named section header of a common 
object file 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#iiiclude <scnhdr.h> 
#include <ldfcn.h> 

int Idshread (Idptr, sectindx, secthead) 
LDFILE ♦Idptr; 
unsigned short sectindx; 
SCNHDR •secthead; 

int Idnshread (Idptr, sectname, secthead) 
LDFILE 'Idptr; 
char *sectname; 
SCNHDR *secthead; 

DESCRIPTION 

Ldshread reads the section header specified by sectindx of the common object 
file currently associated with Idptr into the area of memory beginning at sect- 
head. 

Ldnshread reads the section header specified by sectname into the area of 
memory beginning at secthead. 

Ldshread and Idnshread return SUCCESS or FAILURE. Ldshread will fail if 
sectindx is greater than the number of sections in the object file; Idnshread will 
fail if there is no section name corresponding with sectname. Either function 
will fail if it cannot read the specified section header. 

Note that the first section header has an index of one. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

IdcloseOX), IdopenOX), ldfcn(4). 
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NAME 

Idsseek, Idnsseek — seek to an indexed/named section of a common object file 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#iiiclude <ldfcn.h> 

int Idsseek (Idptr, sectindx) 
LDFILE ♦Idptr; 
unsigned short sectindx; 

int Idnsseek (Idptr, sectname) 
LDFILE 'Idptr; 
char 'sectname; 

DESCRIPTION 

Ldsseek seeks to the section specified by sectindx of the common object file 
currently associated with Idptr. 

idnsseek seeks to the section specified by sectname. 

Ldsseek and Idnsseek return SUCCESS or FAILURE. Ldsseek will fail if sec- 
tindx is greater than the number of sections in the object file; Idnsseek will fail 
if there is no section name corresponding with sectname. Either function will 
fail if there is no section data for the specified section or if it cannot seek to the 
specified section. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

IdcloseOX), IdopenOX), IdshreadOX), ldfcn(4). 
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NAME 

Idtbindex — compute the index of a symbol table entry of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <syms.h> 

#include <ldfcn.h> 

long Idtbindex (Idptr) 
LDFILE 'Idptr,- 

DESCRIPTION 

Ldtbindex returns the (long) index of the symbol table entry at the current 
position of the common object file associated with Idptr. 

The index returned by Idtbindex may be used in subsequent calls to 
Idthread (3X) . However, since Idtbindex returns the index of the symbol table 
entry that begins at the current position of the object file, if Idtbindex is called 
immediately after a particular symbol table entry has been read, it will return 
the index of the next entry. 

Ldtbindex will fail if there are no symbols in the object file, or if the object file 
is not positioned at the beginning of a symbol table entry. 

Note that the first symbol in the symbol table has an index of zero. 

The program must be loaded with the object file access routine library libld.a. 



SEE ALSO 

Idclose(3X), IdopenOX), IdtbreadOX), IdtbseekOX), ldfcn(4). 
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NAME 

Idtbread — read an indexed symbol table entry of a common object file 

SYNOPSIS 

#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <ldfcn.h> 

int Idtbread (Idptr, symindex, symbol) 
LDFILE 'Idptr; 
long symindex; 
SYMENT *symbol; 

DESCRIPTION 

Ldtbread reads the symbol table entry specified by symindex of the common 
object file currently associated with Idptr into the area of memory beginning at 
symbol. 

Ldtbread returns SUCCESS or FAILURE. Ldtbread will fail if symindex is 
greater than the number of symbols in the object file, or if it cannot read the 
specified symbol table entry. 

Note that the first symbol in the symbol table has an index of zero. 
The program must be loaded with the object file access routine library libld.a. 
SEE ALSO 

IdcloseOX), IdopenOX), IdtbseekOX), IdgetnameOX), ldfcn(4). 
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NAME 

Idtbseek — seek to the symbol table of a common object file 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <Idfcn.h> 

int Idtbseek (Idptr) 
LDFILE -Idptr; 

DESCRIPTION 

Ldtbseek seeks to the symbol table of the object file currently associated with 
Idptr. 

Ldtbseek returns SUCCESS or FAILURE, Ldtbseek will fail if the symbol table 
has been stripped from the object file, or if it cannot seek to the symbol table. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

IdcloseOX), IdopenOX), IdtbreadOX), ldfcn(4). 
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NAME 

logname — return login name of user 

SYNOPSIS 

char •lognameC ) 

DESCRIPTION 

Logname returns a pointer to the null-terminated login name; it extracts the 
SLOGNAME variable from the user's environment. 

This routine is kept in /lib/libPW.a. 

FILES 

/etc/profile 

SEE ALSO 

profile(4), environ (5). 

env(l), login(l) in the UNIX System V User Reference Manual. 

BUGS 

The return values point to static data whose content is overwritten by each call. 
This method of determining a login name is subject to forgery. 
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NAME 

malloc, free, realloc, calloc, mallopt, mallinfo — fast main memory allocator 

SYNOPSIS 

#include <malloc.h> 

char *malloc (size) 
unsigned size; 

void free (ptr) 
char «ptr; 

char *reanoc (ptr, size) 
char ♦ptr; 
unsigned size; 

char *calloc (nelem, elsize) 
unsigned nelem, elsize; 

int mallopt (cmd, value) 
int cmd, value; 

struct mallinfo mallinfo (max) 
int max; 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package, 
which runs considerably faster than the malloc (3C) package. It is found in the 
library "malloc", and is loaded if the option "— Imalloc" is used with ceil) or 
ldi\). 

Malloc returns a pointer to a block of at least size bytes suitably aligned for 
any use. 

The argument to free is a pointer to a block previously allocated by malloc; 
after free is performed this space is made available for further allocation, and 
its contents have been destroyed (but see mallopt below for a way to change 
this behavior). 

Undefined results will occur if the space assigned by malloc is overrun or if 
some random number is handed to free. 

Realloc changes the size of the block pointed to by ptr to size bytes and 
returns a pointer to the (possibly moved) block. The contents will be 
unchanged up to the lesser of the new and old sizes. 

Calloc allocates space for an array of nelem elements of size elsize. The space 
is initialized to zeros. 

Mallopt provides for control over the allocation algorithm. The available 
values for cmd are: 

M MXFAST Set maxfast to value. The algorithm allocates all blocks below 
the size of maxfast in large groups and then doles them out 
very quickly. The default value for maxfast is 0. 

M NLBLKS Set numlblks to value. The above mentioned "large groups" 
each contain numlblks blocks. Numlblks must be greater than 
0. The default value for numlblks is 100. 

M GRAIN Set grain to value. The sizes of all blocks smaller than max- 
fast are considered to be rounded up to the nearest multiple of 
grain. Grain must be greater than 0. The default value of 
grain is the smallest number of bytes which will allow align- 
ment of any data type. Value will be rounded up to a multiple 
of the default when grain is set. 
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M_KEEP Preserve data in a freed block until the next malloc, realloc, 

or calloc. This option is provided only for compatibility with 
the old version of malloc and is not recommended. 

These values are defined in the <malloc.h> header file. 

Mallopt may be called repeatedly, but may not be called after the first small 
block is allocated. 



Mallinfo provides instrumentation describing space usage, 
ture: 



It returns the struc- 



struct mallinfo 



int arena; 


/* 


int ordblks; 


/* 


int smblks; 


/* 


int hblkhd; 


/* 


int hblks; 


/* 


int usmblks; 


/* 


int fsmblks; 


/* 


int uordblks; 


/* 


int fordblks; 


/* 


int keepcost; 


/* 




/* 



total space in arena */ 
number of ordinary blocks */ 
number of small blocks */ 
space in holding block headers * 
number of holding blocks */ 
space in small blocks in use */ 
space in free small blocks */ 
space in ordinary blocks in use * 
space in free ordinary blocks */ 
space penalty if keep option */ 
is used */ 



This structure is defined in the <malloc.h> header file. 

Each of the allocation routines returns a pointer to space suitably aligned (after 
possible pointer coercion) for storage of any type of object. 

SEE ALSO 

brk(2), malloc (3C). 

DIAGNOSTICS 

Malloc, realloc and calloc return a NULL pointer if there is not enough avail- 
able memory. When realloc returns NULL, the block pointed to by ptr is left 
intact. If mallopt is called after any allocation or if cmd or value are invalid, 
non-zero is returned. Otherwise, it returns zero. 

WARNINGS 

This package usually uses more data space than malloc(3C). 
The code size is also bigger than malloc (3C) . 

Note that unlike malloci3C), this package does not preserve the contents of a 
block when it is freed, unless the M KEEP option of mallopt is used. 
Undocumented features of malloc i3C) have not been duplicated. 
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NAME 

plot — graphics interface subroutines 

SYNOPSIS 

openpl 0 

erase 0 

label (s) 
char 's; 

line (xl, yl, x2, y2) 
int xl, yl, x2, y2; 

circle (x, y, r) 
int X, y, r; 

arc (x, y, xO, yO, xl, yl) 
int x, y, xO, yO, xl, yl; 

move (x, y) 
int X, y; 

cont (x, y) 
int X, y; 

point (x, y) 
int X, y; 

linemod (s) 
char *s; 

space (xO, yO, xl, yl) 
int xO, yO, xl, yl; 

closepl 0 

DESCRIPTION 

These subroutines generate graphic output in a relatively device-independent 
manner. Space must be used before any of these functions to declare the 
amount of space necessary. See plot {A). Openpl must be used before any of 
the others to open the device for writing. Closepl flushes the output. 

Circle draws a circle of radius r with center at the point (x. y) . 

Arc draws an arc of a circle with center at the point (x, y) between the points 
(xO, yO) and (xl.yl). 

String arguments to label and linemod are terminated by nulls and do not con- 
tain new-lines. 

See plot (4) for a description of the effect of the remaining functions. 
The library files listed below provide several flavors of these routines. 



FILES 



/usr/lib/libplot.a produces output for tplot (IG) filters 

/usr/lib/lib300.a for DASI 300 

/usr/lib/lib300s.a for DASI 300s 

/usr/lib/lib450.a for DASI 450 

/usr/lib/lib4014.a for TEKTRONIX 4014 
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WARNINGS 

In order to compile a program containing these functions in file.c it is necessary 
to use "cc file.c — Iplot". 

In order to execute it, it is necessary to use "a.out | tplot". 

The above routines use <stdio.h>, which causes them to increase the size of 
programs, not otherwise using standard I/O, more than might be expected. 

SEE ALSO 

plot (4). 

graph(lG), stat(lG), tplot(lG) in the UNIX System V User Reference Manual. 
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NAME 

regcmp, regex — compile and execute regular expression 
SYNOPSIS 

char *regcmp (string 1 [, string2, ...1, (char *)0) 
char ♦string 1, ♦stringZ, 

char *regex (re, subject!, retO, ...1) 
char *re, *subject, *retO, 

extern char * loci; 

DESCRIPTION 

Regcmp compiles a regular expression and returns a pointer to the compiled 
form. Malloc(3C) is used to create space for the vector. It is the user's 
responsibility to free unneeded space so allocated. A NULL return from 
regcmp indicates an incorrect argument. Regcmp i\) has been written to gen- 
erally preclude the need for this routine at execution time. 

Regex executes a compiled pattern against the subject string. Additional argu- 
ments are passed to receive values back. Regex returns NULL on failure or a 
pointer to the next unmatched character on success. A global character pointer 
loci points to where the match began. Regcmp and regex were mostly bor- 
rowed from the editor, edii); however, the syntax and semantics have been 
changed slightly. The following are the valid symbols and their associated 
meanings. 

[ 1 * These symbols retain their current meaning. 

$ Matches the end of the string; \n matches a new-line. 

— Within brackets the minus means through. For example, [a— zl is 

equivalent to [abcd...xyzl. The — can appear as itself only if used as 
the first or last character. For example, the character class expression 
[1 — 1 matches the characters 1 and — . 

+ A regular expression followed by + means one or more times. For 

example, [0-91-1- is equivalent to [0-9H0-91*. 

(m) {m,} {m,u} 

Integer values enclosed in {} indicate the number of times the preced- 
ing regular expression is to be applied. The value m is the minimum 
number and w is a number, less than 256, which is the maximum. If 
only m is present (e.g., {m}), it indicates the exact number of times 
the regular expression is to be applied. The value {m,} is analogous to 
{m, infinity}. The plus (+) and star (•) operations are equivalent to 
{l,} and {O,} respectively. 

( ... 

The value of the enclosed regular expression is to be returned. The 
value will be stored in the (n + Oih. argument following the subject 
argument. At most ten enclosed regular expressions are allowed. 
Regex makes its assignments unconditionally. 

(...) Parentheses are used for grouping. An operator, e.g., {}, can 

work on a single character or a regular expression enclosed in 
parentheses. For example, (a*(cb+)*)$0. 

By necessity, all the above defined symbols are special. They must, therefore, 
be escaped to be used as themselves. 
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EXAMPLES 

Example 1: 

char *cursor, *newcursor, *ptr; 

newcursor = regex((ptr = regcmp("''\n", 0)), cursor); 
free(ptr); 

This example will match a leading new-line in the subject string pointed at by 
cursor. 

Example 2: 

char ret0[9]; 

char ♦newcursor, *name; 

name = regcmp("([A-Za-z][A~za-zO-9j{0,7})$0", 0); 
newcursor = regex(name, "123Testing321", retO); 

This example will match through the string "TestingS" and will return the 
address of the character after the last matched character (cursor+ll). The 
string "TestingS" will be copied to the character array retO. 

Example 3: 

#include "file.i" 

char 'String, *newcursor; 

newcursor = regex(name, string); 

This example applies a precompiled regular expression in file.i (see regcmpil)) 
against string. 

This routine is kept in /lib/libPW.a. 

SEE ALSO 

malloc(3C). 

ed(l), regcmp(l) in the UNIX System V User Reference Manual. 

BUGS 

The user program may run out of memory if regcmp is called iteratively 
without freeing the vectors no longer required. The following user-supplied 
replacement for mallocOO reuses the same vector saving time and space: 

/* user's program */ 

char * 
malloc(n) 
unsigned n; 
{ 

static char rebuf[512]; 

return (n <= sizeof rebuf) ? rebuf : NULL; 

} 
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NAME 

sputl, sgetl — access long integer data in a machine-independent fashion. 

SYNOPSIS 

void sputl (value, buffer) 
long value; 
char 'buffer; 

long sgetl (buffer) 
char *buffer; 

DESCRIPTION 

Sputl takes the four bytes of the long integer value and places them in memory 
starting at the address pointed to by buffer. The ordering of the bytes is the 
same across all machines. 

Sgetl retrieves the four bytes in memory starting at the address pointed to by 
buffer and returns the long integer value in the byte ordering of the host 
machine. 

The combination of sputl and sgetl provides a machine-independent way of 
storing long numeric data in a file in binary form without conversion to charac- 
ters. 

A program which uses these functions must be loaded with the object-file 
access routine library libld.a. 
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NAME 

vprintf, vfprintf, vsprintf — print formatted output of a varargs argument list 

SYNOPSIS 

#inciude <stdio.h> 
#include <varargs.h> 

int vprintf (format, ap) 
char •format; 
vajist ap; 

int vfprintf (stream, format, ap) 
FILE ♦stream; 
char *format; 
vajist ap; 

int vsprintf (s, format, ap) 
char ♦s, ♦format; 
vajist ap; 

DESCRIPTION 

vprintf, vfprintf, and vsprintf are the same as printf, fprintf, and sprintf 
respectively, except that instead of being called with a variable number of argu- 
ments, they are called with an argument list as defined by varargs (5). 

EXAMPLE 

The following demonstrates how vfprintf could be used to write an error rou- 
tine. 

#include <stdio.h> 
#include <varargs.h> 



/* 

* error should be called like 

* error(function_name, format, argl, arg2...); 
*/ 

AVARARGSO*/ 
void 

error (vaalist) 

/* Note that the function_,iame and' format arguments cannot be 

* separately declared because of the definition of varargs. 
*/ 

va_dcl 
{ 

vajist args; 
char *fmt; 

va_start(args); 

/* print out name of function causing error */ 

(void) fprintf (stderr, "ERROR in %s: ", va_arg(args, char *)); 

fmt = va_arg(args, char *); 

/* print out remainder of message */ 

(void)vfprintf(fmt, args); 

va_end(args); 

(void) abort ( ); 

} 

SEE ALSO 

printf (3S), varargs(5). 



- 1 - 



ABORT (3F) 



ABORT (3F) 



NAME 

abort — terminate Fortran program 

SYNOPSIS 

call abort ( ) 

DESCRIPTION 

Abort terminates the program which calls it, closing all open files truncated to 
the current position of the file pointer. 

DIAGNOSTICS 

When invoked, abort prints "Fortran abort routine called" on the standard 
error output. 

SEE ALSO 

abortOC). 
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NAME 

abs, iabs, dabs, cabs, zabs — Fortran absolute value 

SYNOPSIS 

integer il, i2 
real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 
double complex dxl, dx2 

r2 = abs(rl) 

i2 = iabs(il) 
i2 = abs(il) 

dp2 = dabs (dpi) 
dp2 = abs(dpl) 

cx2 = cabs (cxl) 
0x2 = abs (cxl) 

dx2 = zabs (dxl) 
dx2 = abs (dxl) 

DESCRIPTION 

Abs is the family of absolute value functions. labs returns the integer absolute 
value of its integer argument. Dabs returns the double-precision absolute value 
of its double-precision argument. Cabs returns the complex absolute value of 
its complex argument. Zabs returns the double-complex absolute value of its 
double-complex argument. The generic form abs returns the type of its argu- 
ment. 

SEE ALSO 

floor (3 M). 
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NAME 

acos, dacos — Fortran arccosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = acos(rl) 

dp2 = dacos(dpl) 
dp2 = acos (dpi) 

DESCRIPTION 

Acos returns the real arccosine of its real argument. Dacos returns the 
double-precision arccosine of its double-precision argument. The generic form 
acos may be used with impunity as its argument will determine the type of the 
returned value. 

SEE ALSO 

trigOM). 



- 1 - 



AIMAGOF) 



AIMAGOF) 



NAME 

aimag, dimag — Fortran imaginary part of complex argument 

SYNOPSIS 

real r 

complex cxr 
double precision dp 
double complex cxd 

r = aimag(cxr) 

dp = dimag (cxd) 

DESCRIPTION 

Aimag returns the imaginary part of its single-precision complex argument. 
Dimag returns the double-precision imaginary part of its double-complex argu- 
ment. 
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NAME 

aint, dint — Fortran integer part intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = aint(rl) 

dpi = dint(dpl) 
dp2 = aint(dpl) 

DESCRIPTION 

Aint returns the truncated value of its real argument in a real. Dint returns 
the truncated value of its double-precision argument as a double-precision 
value. Aint may be used as a generic function name, returning either a real or 
double-precision value depending on the type of its argument. 
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NAME 

asin, dasin — Fortran arcsine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = asin(rl) 

dp2 = dasin (dpi) 
dp2 = asin(dpl) 

DESCRIPTION 

Asin returns the real arcsine of its real argument. Dasin returns the double- 
precision arcsine of its double-precision argument. The generic form asin may 
be used with impunity as it derives its type from that of its argument. 

SEE ALSO 

trigOM). 
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NAME 

atan, datan — Fortran arctangent intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = atan(rl) 

dp2 = datan(dpl) 
dp2 = atan(dpl) 

DESCRIPTION 

Atan returns the real arctangent of its real argument. Datan returns the 
double-precision arctangent of its double-precision argument. The generic form 
atan may be used with a double-precision argument returning a double- 
precision value. 

SEE ALSO 

trigOM). 
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NAME 

atan2, datan2 — Fortran arctangent intrinsic function 

SYNOPSIS 

real rl, r2, r3 

double precision dpi, dp2, dp3 

r3 = atan2(rl, r2) 

dp3 = datan2(dpl, dp2) 
dp3 = atan2(dpl, dp2) 

DESCRIPTION 

Atan2 returns the arctangent of argl/arg2 as a real value. Datanl returns the 
double-precision arctangent of its double-precision arguments. The generic 
form atan2 may be used with impunity with double-precision arguments. 

SEE ALSO 

trig (3 M). 
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NAME 

and, or, xor, not, Ishift, rshift — Fortran bitwise boolean functions 

SYNOPSIS 

integer i, j, k 
real a, b, c 

double precision dpi, dp2, dp3 

k = andO, j) 
c = or (a, b) 
j = xor(i, a) 
j = not(i) 
k = Ishift (i, j) 
k = rshift(i, j) 

DESCRIPTION 

The generic intrinsic boolean functions and, or and xor return the value of the 
binary operations on their arguments. Not is a unary operator returning the 
one's complement of its argument. Lshift and rshift return the value of the 
first argument shifted left or right, respectively, the number of times specified 
by the second (integer) argument. 

The boolean functions are generic, that is, they are defined for all data types as 
arguments and return values. Where required, the compiler will generate 
appropriate type conversions. 

NOTE 

Although defined for all data types, use of boolean functions on any but integer 
data is bizarre and will probably result in unexpected consequences. 

BUGS 

The implementation of the shift functions may cause large shift values to 
deliver weird results. 
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NAME 

conjg, dconjg — Fortran complex conjugate intrinsic function 

SYNOPSIS 

complex cxl, cx2 
double complex dxl, dx2 

0x2 = conjg (cxl) 

dx2 = dconjg (dxl) 

DESCRIPTION 

Conjg returns the complex conjugate of its complex argument. Dconjg returns 
the double-complex conjugate of its double-complex argument. 
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NAME 

COS, dcos, ccos — Fortran cosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = cos(rl) 

dp2 - dcos(dpl) 
dp2 = cos (dpi) 

cx2 = ccos(cxl) 
cx2 = cos (cxl) 

DESCRIPTION 

Cos returns the real cosine of its real argument. Dcos returns the double- 
precision cosine of its double-precision argument. Ccos returns the complex 
cosine of its complex argument. The generic form cos may be used with 
impunity as its returned type is determined by that of its argument. 

SEE ALSO 

trigOM). 
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NAME 

cosh, dcosh — Fortran hyperbolic cosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

rl = cosh(rl) 

dp2 = dcosh(dpl) 
dp2 = cosh (dpi) 

DESCRIPTION 

Cosh returns the real hyperbolic cosine of its real argument. Dcosh returns the 
double-precision hyperbolic cosine of its double-precision argument. The gen- 
eric form cosh may be used to return the hyperbolic cosine in the type of its 
argument. 

SEE ALSO 

sinhOM). 
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NAME 

dim, ddim, idim — positive difference intrinsic functions 

SYNOPSIS 

integer al,a2,a3 
a3 =» idiin(al,a2) 

real al,a2,a3 
a3 = diin(al,a2) 

double precision al,a2.,a3 
a3 => ddim(al,a2) 

DESCRIPTION 

These functions return: 

al-a2 if al > a2 
o if al <== a2 
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NAME 

dprod — double precision product intrinsic function 

SYNOPSIS 

real al,a2 

double precision a3 

a3 = dprod (al,a2) 

DESCRIPTION 

Dprod returns the double precision product of its real arguments. 
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NAME 

exp, dexp, cexp — Fortran exponential intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = exp(rl) 

dp2 = dexp(dpl) 
dp2 = exp (dpi) 

cx2 = clog (cxl) 
cx2 = exp(cxl) 

DESCRIPTION 

Exp returns the real exponential function of its real argument. Dexp 
returns the double-precision exponential function of its double-precision argu- 
ment. Cexp returns the complex exponential function of its complex argument. 
The generic function exp becomes a call to dexp or cexp as required, depend- 
ing on the type of its argument. 

SEE ALSO 

exp(3M). 
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NAME 

int, ifix, idint, real, float, sngl, dble, cmplx, dcmplx, ichar, char — explicit For- 
tran type conversion 

SYNOPSIS 

integer i, j 
real r, s 

double precision dp, dq 
complex cx 
double complex dcx 
character*/ ch 



i = 


int(r) 




int (dp) 




int(cx) 


i = 


int(dcx) 




ifix(r) 




idint (dp) 


r = 


real(i) 


r = 


real (dp) 


r = 


real(cx) 


r = 


real (dcx) 


r = 


float(i) 


r = 


sngl (dp) 


dp = 


= dble(i) 


dp = 


= dble(r) 



dp = dble(cx) 
dp = dble (dcx) 

cx = cmplx(i) 

cx = cmplx(i, j) 

cx = cmplx (r) 

cx = cmplx (r, s) 

cx = cmplx(dp) 

cx = cmplx (dp, dq) 

cx = cmplx (dcx) 

dcx = dcmplx (i) 

dcx = dcmplxd, j) 

dcx = dcmplx (r) 

dcx = dcmplx (r, s) 

dcx = dcmplx (dp) 

dcx = dcmplx (dp, dq) 

dcx = dcmplx (cx) 

i = ichar(ch) 
ch = chard) 

DESCRIPTION 

These functions perform conversion from one data type to another. 

The function int converts to integer form its real, double precision, complex, or ^ 

double complex argument. If the argument is real or double precision, int 'i 

returns the integer whose magnitude is the largest integer that does not exceed 

the magnitude of the argument and whose sign is the same as the sign of the 

argument (i.e. truncation). For complex types, the above rule is applied to the 

real part, ifix and idint convert only real and double precision arguments 

respectively. 
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The function real converts to real form an integer, double precision, complex, 
or double complex argument. If the argument is double precision or double 
complex, as much precision is kept as is possible. If the argument is one of the 
complex types, the real part is returned, float and sngl convert only integer and 
double precision arguments respectively. 

The function dble converts any integer, real, complex, or double complex argu- 
ment to double precision form. If the argument is of a complex type, the real 
part is returned. 

The function cmplx converts its integer, real, double precision, or double com- 
plex argument (s) to complex form. 

The function dcmplx converts to double complex form its integer, real, double 
precision, or complex argument (s). 

Either one or two arguments may be supplied to cmplx and dcmplx . If there is 
only one argument, it is taken as the real part of the complex type and an ima- 
ginary part of zero is supplied. If two arguments are supplied, the first is taken 
as the real part and the second as the imaginary part. 

The function ichar converts from a character to an integer depending on the 
character's position in the collating sequence. 

The function char returns the character in the /th position in the processor col- 
lating sequence where / is the supplied argument. 

For a processor capable of representing n characters, 

ichar (char (i)) = i for 0 < i < «, and 

char (ichar (ch)) = ch for any represen table character ch. 
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NAME 

getarg — return Fortran command-line argument 

SYNOPSIS 

character* N c 
integer i 

getarg (i, c) 

DESCRIPTION 

Getarg returns the i-th command-line argument of the current process. Thus, if 
a program were invoked via 

foo argl arg2 arg3 

getarg(2, c) would return the string "arg2" in the character variable c. 

SEE ALSO 

getoptOC). 
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NAME 

getenv — return Fortran environment variable 

SYNOPSIS 

character ♦N c 

getenv ("TMPDIR", c) 

DESCRIPTION 

Getenv returns the character-string value of the environment variable 
represented by its first argument into the character variable of its second argu- 
ment. If no such environment variable exists, all blanks will be returned. 

SEE ALSO 

getenv (3C), environ (5). 
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NAME 

iargc 

SYNOPSIS 

integer i 
i = iargc 0 

DESCRIPTION 

The iargc function returns the number of command line arguments passed to 
the program. Thus, if a program were invoked via 

foo argl arg2 arg3 

iargcO would return "3". 

SEE ALSO 

getarg(3F). 



( 
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NAME 

index — return location of Fortran substring 

SYNOPSIS 

character* Nl chl 
character«N2 ch2 
integer i 

i — index (chl, ch2) 
DESCRIPTION 

Index returns the location of substring chl in string chl . The value returned is 
the position at which substring ch2 starts, or 0 is it is not present in string chl. 
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NAME 

len — return length of Fortran string 

SYNOPSIS 

character*N ch 
integer i 

i = ien(ch) 

DESCRIPTION 

Len returns the length of string ch. 
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NAME 

log, alog, dlog, clog — Fortran natural logarithm intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = alog(rl) 
r2 = log(rl) 

dp2 = dlog(dpl) 
dp2 = log(dpl) 

cx2 = clog(cxl) 
cx2 = log (cxl) 

DESCRIPTION 

Alog returns the real natural logarithm of its real argument. Dlog returns the 
double-precision natural logarithm of its double-precision argument. Clog 
returns the complex logarithm of its complex argument. The generic function 
log becomes a call to alog, dlog, or clog depending on the type of its argu- 
ment. 

SEE ALSO 

exp(3M). 
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NAME 

log 10, aloglO, dloglO — Fortran common logarithm intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

rl = aloglO(rl) 
r2 = loglO(rl) 

dp2 = dloglO(dpl) 
dp2 = loglO(dpl) 

DESCRIPTION 

AloglO returns the real common logarithm of its real argument. DloglO 
returns the double-precision common logarithm of its double-precision argu- 
ment. The generic function logJO becomes a call to aloglO or dloglO depend- 
ing on the type of its argument. 

SEE ALSO 

exp(3M). 
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NAME 

max, maxO, amaxO, maxl, amaxl, dmaxl — Fortran maximum-value functions 

SYNOPSIS 

integer i, j, k, I 
real a, b, c, d 

double precision dpi, dp2, dp3 

1 = max(i, j, k) 
c = max (a, b) 
dp = max (a, b, c) 
k = maxO(i, j) 
a = amaxO(i, j, k) 
i = maxl (a, b) 
d = amaxl (a, b, c) 
dp3 = dmaxl (dpi, dp2) 

DESCRIPTION 

The maximum-value functions return the largest of their arguments (of which 
there may be any number). Max is the generic form which can be used for all 
data types and takes its return type from that of its arguments (which must all 
be of the same type). MaxO returns the integer form of the maximum value of 
its integer arguments; amaxO, the real form of its integer arguments; maxl, 
the integer form of its real arguments; amaxl, the real form of its real argu- 
ments; and dmaxl , the double-precision form of its double-precision arguments. 

SEE ALSO 

min(3F). 
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NAME 

mclock — return Fortran time accounting 

SYNOPSIS 

integer i 

i = mclock ( ) 

DESCRIPTION 

Mclock returns time accounting information about the current process and its 
child processes. The value returned is the sum of the current process's user time 
and the user and system times of all child processes. 

SEE ALSO 

times(2), clockOC), system (3F). 
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NAME 

min, minO, aminO, mini, aminl, dminl — Fortran minimum-value functions 

SYNOPSIS 

integer i, j, k, I 
real a, b, c, d 

double precision dpi, dp2, dp3 

1 = mind, j, k) 
c = min (a, b) 
dp = min (a, b, c) 
k = minOO, j) 
a = aminOCi, j, k) 
i = mini (a, b) 
d = aminl (a, b, c) 
dp3 = dminl (dpi, dp2) 

DESCRIPTION 

The minimum-value functions return the minimum of their arguments (of 
which there may be any number). Min is the generic form which can be used 
for all data types and takes its return type from that of its arguments (which 
must all be of the same type). MinO returns the integer form of the minimum 
value of its integer arguments; aminO, the real form of its integer arguments; 
mini, the integer form of its real arguments; aminl, the real form of its real 
arguments; and dminl, the double-precision form of its double-precision argu- 
ments. 

SEE ALSO 

max(3F). 
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NAME 

mod, amod, dmod — Fortran remaindering intrinsic functions 

SYNOPSIS 

integer i, j, k 
real rl, r2, r3 

double precision dpi, dp2, dp3 

k = mod(i, j) 

r3 = amod(rl, r2) 
r3 = mod(rl, r2) 

dp3 = dmod (dpi, dp2) 
dp3 = modCdpl, dp2) 

DESCRIPTION 

Mod returns the integer remainder of its first argument divided by its second 
argument. Amod and dmod return, respectively, the real and double-precision 
whole number remainder of the integer division of their two arguments. The 
generic version mod will return the data type of its arguments. 
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NAME 

irand, rand, srand — random number generator 

SYNOPSIS 

call srand (iseed) 

i = irand 0 

X = rand( ) 

DESCRIPTION 

Irand generates successive pseudo-random numbers in the range from 0 to 

2**15-1. Rand generates pseudo-random numbers distributed in (0, 1.0). 
Srand uses its integer argument to re-initialize the seed for successive invoca- 
tions of irand and rand. 

SEE ALSO 

randOC). 
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NAME 

anint, dnint, nint, idnint — Fortran nearest integer functions 

SYNOPSIS 

integer i 
real rl, r2 

double precision dpi, dp2 

rl = anint (rl) 
i = nint(rl) 

dp2 = anint (dpi) 
dp2 — dnint(dp]) 

i = nint (dpi) 
i = idnint(dpl) 

DESCRIPTION 

Anint returns the nearest whole real number to its real argument (i.e., 
int(a+0.5) if a > 0, int(a— 0.5) otherwise). Dnint does the same for its 
double-precision argument. Nint returns the nearest integer to its real argu- 
ment. Idnint is the double-precision version. Anint is the generic form of 
anint and dnint , performing the same operation and returning the data type of 
its argument. Nint is also the generic form of idnint. 
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NAME 

sign, isign, dsign — Fortran transfer-of-sign intrinsic function 

SYNOPSIS 

integer i, j, k 
real rl, r2, r3 

double precision dpi, dp2, dp3 

k = isign(i, j) 
k = sign(i, j) 

r3 = sign(rl, r2) 

dp3 = dsign (dpi, dp2) 
dp3 = signCdpl, dp2) 

DESCRIPTION 

Isign returns the magnitude of its first argument with the sign of its second 
argument. Sign and dsign are its real and double-precision counterparts, 
respectively. The generic version is sign and will devolve to the appropriate 
type depending on its arguments. 
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NAME 

signal — specify Fortran action on receipt of a system signal 

SYNOPSIS 

integer 1 

external integer intfnc 
call signal (i, intfnc) 

DESCRIPTION 

Signal allows a process to specify a function to be invoked upon receipt of a 
specific signal. The first argument specifies which fault or exception; the second 
argument the specific function to be invoked. 

SEE ALSO 

kill(2), signal(2). 
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NAME 

sin, dsin, csin — Fortran sine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = sin(rl) 

dp2 = dsin(dpl) 
dp2 = sin(dpl) 

cx2 = csin (cxl) 
cx2 = sin(cxl) 

DESCRIPTION 

Sin returns the real sine of its real argument. Dsin returns the double- 
precision sine of its double-precision argument. Csin returns the complex sine 
of its complex argument. The generic sin function becomes dsin or csin as 
required by argument type. 

SEE ALSO 

trig(3M). 
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NAME 

sinh, dsinh — Fortran hyperbolic sine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = sinh(rl) 

dp2 = dsinh(dpl) 
dp2 = sinh(dpl) 

DESCRIPTION 

Sinh returns the real hyperbolic sine of its real argument. Dsinh returns the 
double-precision hyperbolic sine of its double-precision argument. The generic 
form sinh may be used to return a double-precision value when given a 
double-precision argument. 

SEE ALSO 

sinh(3M). 
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NAME 

sqrt, dsqrt, csqrt — Fortran square root intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = sqrt(rl) 

dp2 = dsqrt(dpl) 
dp2 = sqrt(dpl) 

cx2 = csqrt (cxl) 
cx2 = sqrt(cxl) 

DESCRIPTION 

Sqrt returns the real square root of its real argument. Dsqrt returns the 
double-precision square root of its double-precision argument. Csqrt returns 
the complex square root of its complex argument. Sqrt, the generic form, will 
become dsqrt or csqrt as required by its argument type. 

SEE ALSO 

exp(3M). 
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NAME 

Ige, Igt, He, lit — string comparision intrinsic functions 

SYNOPSIS 

character*N al, a2 
logical I 

I = Ige (al,a2) 

I = Igt (al,a2) 

I = lie (al,a2) 

I = lit (al,a2) 

DESCRIPTION 

These functions return .TRUE, if the inequality holds and .FALSE, otherwise. 
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NAME 

system — issue a shell command from Fortran 

SYNOPSIS 

character* N c 

call system (c) 

DESCRIPTION 

System causes its character argument to be given to 5/1(1) as input, as if the 
string had been typed at a terminal. The current process waits until the shell 
has completed. 

SEE ALSO 

exec(2), system(3S). 

sh(l) in the UNIX System V User Reference Manual. 
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NAME 

tan, dtan — Fortran tangent intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

rl = tan(rl) 

dp2 = dtan(dpl) 
dp2 = tan (dpi) 

DESCRIPTION 

Tan returns the real tangent of its real argument. Dtan returns the double- 
precision tangent of its double-precision argument. The generic tan function 
becomes dtan as required with a double-precision argument. 

SEE ALSO 

trig (3 M). 
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NAME 

tanh, dtanh — Fortran hyperbolic tangent intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

rl = tanh(rl) 

dp2 = dtanh(dpl) 
dp2 = tanh(dpl) 

DESCRIPTION 

Tanh returns the real hyperbolic tangent of its real argument. Dtanh returns 
the double-precision hyperbolic tangent of its double-precision argument. The 
generic form tanh may be used to return a double-precision value given a 
double-precision argument. 

SEE ALSO 

sinh(3M). 



- 1 - 



INTRO (4) 



INTRO (4) 



NAME 

intro — introduction to file formats 
DESCRIPTION 

This section outlines the formats of various files. The C struct declarations for 
the file formats are given where applicable. Usually, these structures can be 
found in the directories /usr /include or /usr/include/sys. 

References of the type name ilM) refer to entries found in Section 1 of the 
UNIX System V Administrator Reference Manual. 
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NAME 

a. out — common assembler and link editor output 
DESCRIPTION 

The file name a.out is the output file from the assembler asi\) and the link edi- 
tor Id (I). Both programs will make a.out executable if there were no errors in 
assembling or linking and no unresolved external references. 

A common object file consists of a file header, a UNIX system header, a table 
of section headers, relocation information, (optional) line numbers, and a sym- 
bol table. The order is given below. 

File header. 

UNIX system header. 

Section 1 header. 

Section n header. 
Section 1 data. 

Section n data. 
Section 1 relocation. 

Section n relocation. 
Section 1 line numbers. 

Section n line numbers. 
Symbol table. 
String table. 

The last four sections (relocation, line numbers, symbol table and string table) 
may be missing if the program was linked with the — s option of Idil) or if the 
symbol table and relocation bits were removed by strip il). Also note that if 
there were no unresolved external references after linking, the relocation infor- 
mation will be absent. The string table exists only if necessary. 

The sizes of each segment (contained in the header, discussed below) are in 
bytes and are even. 

When an a.out file is loaded into memory for execution, three logical segments 
are set up: the text segment, the data segment (initialized data followed by 
uninitialized, the latter actually being initialized to all O's), and a stack. The 
text segment begins at location 0 in the core image. The header is never 
loaded. If the magic number (the first field in the UNIX system header) is 407 
(octal), it indicates that the text segment is not to be write-protected or shared, 
so the data segment will be contiguous with the text segment. If the magic 
number is 410 (octal), the data segment and the text segment are not writable 
by the program; if other processes are executing the same a.out file, the 
processes will share a single text segment. 

On the 3068, the stack begins at the end of memory and grows towards lower ad- 
dresses. The stack is automatically extended as required. The data segment is 
extended only as requested by the brk (2) system call. 

The value of a word in the text or data portions that is not a reference to an 
undefined external symbol is exactly the value that will appear in memory when 
the file is executed. If a word in the text involves a reference to an undefined 
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external symbol, the storage class of the symbol-table entry for that word will 
be marked as an "external symbol", and the section number will be set to 0. 
When the file is processed by the link editor and the external symbol becomes 
defined, the value of the symbol will be added to the word in the file. 

File Header 

The format of the filehdr header is 

struct filehdr 
{ 



unsigned short 


f_magic; 


/• 


magic number ♦/ 


unsigned short 


fnscns; 


/* 


number of sections */ 


long 


f_timdat; 


/* 


time and date stamp */ 


long 


f_symptr; 


/* 


file ptr to symtab */ 


long 


f_nsyms; 


/* 


# symtab entries */ 


unsigned short 


fopthdr; 


/* 


sizeof(opt hdr) */ 


unsigned short 


fflags; 


/* 


flags ♦/ 



}; 

UNIX System Header 

The format of the VAX UNIX system header is 

typedef struct aouthdr 



short 


magic; 


/* 


magic number */ 


short 


vstamp; 


/* 


version stamp ♦/ 


long 


tsize; 


/* 


text size in bytes, padded */ 


long 


dsize; 


/* 


initialized data (.data) ♦/ 


long 


bsize; 


/* 


uninitialized data (.bss) */ 


long 


entry; 


/• 


entry point */ 


long 


text_start; 


/* 


base of text used for this file */ 


long 


data_start; 


/* 


base of data used for this file */ 



} AOUTHDR; 

The format of the 3B 20 computer UNIX system header is 

typedef struct aouthdr 
{ 



short 


magic; 


/* 


magic number */ 


short 


vstamp; 


/* 


version stamp */ 


long 


tsize; 


/♦ 


text size in bytes, padded */ 


long 


dsize; 


/• 


initialized data (.data) ♦/ 


long 


bsize; 


/* 


uninitialized data (.bss) */ 


long 


duml; 


/* 


unused fill space included */ 


long 


dum2; 


/* 


for historical reasons */ 


long 


entry; 


/* 


entry point */ 


long 


text_start; 


/* 


base of text used for this file ♦/ 


long 


datastart; 


/• 


base of data used for this file •/ 



} AOUTHDR; 
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Section Header 

The format of the section header is 

struct scnhdr 
{ 

char s_name[SYMNMLEN];/* section name */ 

long s_paddr; /* physical address */ 

long s_vaddr; /* virtual address */ 

long s_size; /* section size */ 

long s_scnptr; /* file ptr to raw data */ 

long s_relptr; /* file ptr to relocation */ 

long s lnnoptr; /* file ptr to line numbers */ 

unsigned short s_nreloc; /* # reloc entries */ 

unsigned short s_nlnno; /* # line number entries */ 

long s_flags; /* flags */ 

}; 

Relocation 

Object files have one relocation entry for each relocatable reference in the text 
or data. If relocation information is present, it will be in the following format: 

struct reloc 
{ 

long r_vaddr; /* (virtual) address of reference */ 

long r_symndx; /* index into symbol table */ 

short r_type; /* relocation type */ 



The start of the relocation information is sjelptr from the section header. If 
there is no relocation information, sjelptr is 0. 
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Symbol Table 

The format of the symbol table header is 

#define SYMNMLEN 8 
#define FILNMLEN 14 

#define SYMESZ 18 /* the size of a SYMENT */ 



struct syment 
{ 

union 
{ 

char 

struct 

{ 

long 
long 

} _n_n; 

char 

}_n; 

unsigned long 
short 

unsigned short 

char 

char 



/* all ways to get a symbol name */ 
_n_name[SYMNMLEN]; /♦ name of symbol */ 



n zeroes; /* == OL if in string table */ 

_n_offset; /* location in string table ♦/ 

*_n_nptr[2]; /* allows overlaying */ 

n_value; /* value of symbol ♦/ 

n_scnum; /* section number */ 

n_type; /* type and derived type •/ 

n_sclass; /* storage class */ 

n numaux; /* number of aux entries */ 



#define n_name _n._n_name 

#define n_zeroes _n._n_n._n_zeroes 

#define n_offset _n._n_n._n_offset 

#define n nptr _n._n_nptr[ 1 ] 

Some symbols require more information than a single entry; they are followed 
by auxiliary entries that are the same size as a symbol entry. The format fol- 
lows. 
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union auxent { 
struct { 

long xtagndx; 
union { 

struct { 

unsigned short xjnno; 
unsigned short x size; 

} xjnsz; 

long xfsize; 
) x_misc; 
union { 

struct { 

long xlnnoptr; 
long xendndx; 

} x fcn; 
struct { 

unsigned short x_dimen[DIMNUM]; 

} x_ary; 
) x_fcnary; 

unsigned short x tvndx; 
} x_sym; 

struct { 

char x_fname[FILNMLEN]; 
} xjile; 

struct { 

long xscnlen; 

unsigned short x nreloc; 

unsigned short x nlinno; 
} x_scn; 

struct { 

long xjvfill; 
unsigned short x tvlen; 
unsigned short x_tvran[2]; 

} X tv; 

}; 

Indexes of symbol table entries begin at zero. The start of the symbol table is 
fjymptr (from the file header) bytes from the beginning of the file. If the 
symbol table is stripped, fjymptr is 0. The string table (if one exists) begins 
at f jymptr + (fjisyms * SYMESZ) bytes from the beginning of the file. 

SEE ALSO 

brk(2), filehdr(4), ldfcn(4), linenum(4), reloc(4), scnhdr(4), syms(4). 
as(l), cc(l), ld(l) in the UNIX System V User Reference Manual. 
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NAME 

acct — per-process accounting file format 

SYNOPSIS 

#include <sys/acct.h> 

DESCRIPTION 

Files produced as a result of calling acct (2) have records in the form defined by 
<sys/acct.h>, whose contents are: 

typedef ushort comp_t; /♦ "floating point" */ 

/* 13-bit fraction, 3-bit exponent */ 



acct 








cnar 


acflag; 


/* 


Accounting flag */ 


char 


acstat; 


/* 


Exit status */ 


ushort 


acuid; 






ushort 


ac_gid; 






devt 


acjty; 






timet 


acbtime; 


/* 


Beginning time */ 


compt 


acutime; 


/* 


acctng user time in clock ticks */ 


compt 


ac_stime; 


/• 


acctng system time in clock ticks ♦/ 


compt 


acetime; 


/♦ 


acctng elapsed time in clock ticks »/ 


compt 


acmem; 


/* 


memory usage in clicks ♦/ 


compt 


acio; 


/* 


chars trnsfrd by read/write */ 


compt 


ac rw; 


/* 


number of block reads/writes */ 


char 


ac_comm[8]; /* 


command name ♦/ 


struct 


acct 


acctbuf; 


struct 


inode 


*acctp; /* inode of accounting file */ 



#define AFORK 01 /* has executed fork, but no exec */ 

#define ASU 02 /* used super-user privileges */ 

#define ACCTF 0300 /♦ record type: 00 = acct •/ 

In ac Jlag, the AFORK flag is turned on by each forkil) and turned off" by an 
exec (.2). The ac comm field is inherited from the parent process and is reset 
by any exec. Each time the system charges the process with a clock tick, it 
also adds to acjnem the current process size, computed as follows: 

(data size) + (text size) / (number of in-core processes using text) 

The value of acjnem / (ac stime + ac utime) can be viewed as an approxima- 
tion to the mean process size, as modified by text-sharing. 
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The structure tacct.h, which resides with the source files of the accounting com- 
mands, represents the total accounting format used by the various accounting 
commands: 

/* 

♦ total accounting (for acct period), also for day 
♦/ 

struct tacct { 



uid t ta uid; /* userid */ 

char ta_name[8]; /* login name */ 

float ta_cpu[2]; /* cum. cpu time, p/np (mins) */ 

float ta_kcore[2]; /* cum kcore-minutes, p/np */ 

float ta_con[2]; /* cum. connect time, p/np, mins */ 

float ta du; /* cum. disk usage */ 

long ta_pc; /* count of processes */ 



unsigned short ta_sc; /* count of login sessions */ 

unsigned short ta dc; /* count of disk samples */ 

unsigned short ta fee; /* fee for special services ♦/ 

); 

SEE ALSO 

acct (2), exec (2), fork (2). 

acct(lM) in the UNIX System V Administrator Reference Manual. 
acctcom(l) in the UNIX System V User Reference Manual. 

BUGS 

The ac mem value for a short-lived command gives little information about the 
actual size of the command, because ac mem may be incremented while a 
different command (e.g., the shell) is being executed by the process. 
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NAME 

ar — common archive file format 
DESCRIPTION 

The archive command aril) is used to combine several files into one. Archives 
are used mainly as libraries to be searched by the link editor Idil). 

Each archive begins with the archive magic string. 

#define ARMAG "!<arch>\n" /* magic string */ 

#define SARMAG 8 /* length of magic string */ 



Each archive which contains common object files (see a.outiA)) includes an 
archive symbol table. This symbol table is used by the link editor Idil) to 
determine which archive members must be loaded during the link edit process. 
The archive symbol table (if it exists) is always the first file in the archive (but 
is never listed) and is automatically created and/or updated by ar. 

Following the archive magic string are the archive file members. Each file 
member is preceded by a file member header which is of the following format: 

#define ARFMAG "'\n" /* header trailer string */ 



struct ar hdr 



{ 



char 
char 
char 
char 
char 
char 
char 



ar_name[ 16]; 

ar_date[12]; 

ar_uid[6]; 

ar jgid[6]; 

ar_mode[8]; 

ar_size[lO]; 

ar_fmag[2]; 



/* file member header */ 

/* 7' terminated file member name */ 

/* file member date */ 

/* file member user identification */ 

/* file member group identification */ 

/* file member mode (octal) */ 

/* file member size */ 

/* header trailer string */ 



All information in the file member headers is in printable ASCII. The numeric 
information contained in the headers is stored as decimal numbers (except for 
arjnode which is in octal). Thus, if the archive contains printable files, the 
archive itself is printable. 

The arjiame field is blank-padded and slash (/) terminated. The ar date field 
is the modification date of the file at the time of its insertion into the archive. 
Common format archives can be moved from system to system as long as the 
portable archive command aril) is used. 



Each archive file member begins on an even byte boundary; a newline is 
inserted between files if necessary. Nevertheless the size given reflects the 
actual size of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive file. 

If the archive symbol table exists, the first file in the archive has a zero length 
name (i.e., arjnamelOl == '/'). The contents of this file are as follows: 

• The number of symbols. Length: 4 bytes. 

• The array of offsets into the archive file. Length: 4 bytes * "the 
number of symbols". 
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• The name string table. Length: ar size — (4 bytes * ("the number of 
symbols" +0). 

The number of symbols and the array of offsets are managed with sgetl and 
sputl. The string table contains exactly as many null terminated strings as 
there are elements in the offsets array. Each offset from the array is associated 
with the corresponding name from the string table (in order). The names in 
the string table are all the defined global symbols found in the common object 
files in the archive. Each offset is the location of the archive header for the 
associated symbol. 

SEE ALSO 

sputl (3X), a.out(4). 

ar(l), ld(l), strip(l) in the UNIX System V User Reference Manual. 
CAVEATS 

Strip{\) will remove all archive symbol entries from the header. The archive 
symbol entries must be restored via the ts option of the ar{\) command before 
the archive can be used with the link editor W(l). 
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NAME 

checklist — list of file systems processed by fsck 
DESCRIPTION 

Checklist resides in directory /etc and contains a list of, at most, 15 special file 
names. Each special file name is contained on a separate line and corresponds 
to a file system. Each file system will then be automatically processed by the 
fsckiXM) command. 

SEE ALSO 

fsck(lM) in the UNIX System V Administrator Reference Manual. 
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NAME 

core — format of core image file 
DESCRIPTION 

The UNIX system writes out a core image of a terminated process when any of 
various errors occur. See signalil) for the list of reasons; the most common 
are memory violations, illegal instructions, bus errors, and user-generated quit 
signals. The core image is called core and is written in the process's working 
directory (provided it can be; normal access controls apply). A process with an 
effective user ID different from the real user ID will not produce a core image. 

The first section of the core image is a copy of the system's per-user data for 
the process, including the registers as they were at the time of the fault. The 
size of this section depends on the parameter usize, which is defined in 
/usr/include/sys/param.h. The remainder represents the actual contents of the 
user's core area when the core image was written. If the text segment is read- 
only and shared, or separated from data space, it is not dumped. 

The format of the information in the first section is described by the user struc- 
ture of the system, defined in /usr/include/sys/user.h. The important stuff not 
detailed therein is the locations of the registers, which are outlined in 
/usr/include/sys/reg.h. 

SEE ALSO 

setuid(2), signal(2). 

crash (IM) in the UNIX System V Administrator Reference Manual. 
sdb(l) in the UNIX System V User Reference Manual. 
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NAME 

cpio — format of cpio archive 
DESCRIPTION 

The header structure, when the — c option of cpioiX) is not used, is: 
struct { 

short hmagic, 

hdev; 
ushort hino, 

hmode, 

huid, 

h^id; 
short hnlink, 

hrdev, 

h_mtime[2], 

hnamesize, 

h_filesize[2]; 
char h_name[h_namesize rounded to word]; 

} Hdr; 

When the — c option is used, the header information is described by: 

sscanf (Chdr,"%6o%6o%6o%6o%6o%6o%6o%6o% 1 1 lo%6o% 1 1 lo%s", 
&Hdr.h_magic, &Hdr.h_dev, &Hdr.h_ino, &Hdr.h_mode, 
&Hdr.h_uid, &Hdr.hjgid, &Hdr.h_nlink, &Hdr.h_rdev, 
&Longtime, &Hdr.h_namesize,&Longfile,Hdr.h_name) ; 

Longtime and Longfile are equivalent to Hdr.hjntime and Hdr.h Jilesize, 
respectively. The contents of each file are recorded in an element of the array 
of varying length structures, archive, together with other items describing the 
file. Every instance of h magic contains the constant 070707 (octal). The 
items h dev through hjntime have meanings explained in statil). The length 
of the null-terminated path name h name, including the null byte, is given by 
hnamesize. 

The last record of the archive always contains the name TRAILER!!!. Special 
files, directories, and the trailer are recorded with h Jilesize equal to zero. 

SEE ALSO 

Stat (2). 

cpio(l), find(l) in the UNIX System V User Reference Manual. 
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NAME 

dir — format of directories 

SYNOPSIS 

#include <sys/dir.h> 

DESCRIPTION 

A directory behaves exactly like an ordinary file, save that no user may write 
into a directory. The fact that a file is a directory is indicated by a bit in the 
flag word of its i-node entry (see fsi4)). The structure of a directory entry as 
given in the include file is: 

#ifndef DIRSIZ 
#define DIRSIZ 14 
#endif 

struct direct 
{ 

inot dino; 

char d_name[DIRSIZ]; 

}; 

By convention, the first two entries in each directory are for . and ... The first 
is an entry for the directory itself. The second is for the parent directory. The 
meaning of .. is modified for the root directory of the master file system; there 
is no parent, so . . has the same meaning as .. 

SEE ALSO 

fs(4). 
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NAME 

errfiile — error-log file format 
DESCRIPTION 

When hardware errors are detected by the system, an error record is generated 
and passed to the error-logging daemon for recording in the error log for later 
analysis. The default error log is /usr/adm/errfile. 

The format of an error record depends on the type of error that was encoun- 
tered. Every record, however, has a header with the following format: 

struct errhdr { 



short 
short 
time_t 
int 



etype; 
elen; 
e_time; 
e_cpu; 



/♦ record type */ 
/♦ bytes in record (inc hdr) ♦/ 
/♦ time of day */ 
/* proc recording error - 3B 20 A 
computer only •/ 



permissible 


record types are as 


follows: 




#define 


E_ 


GOTS 


010 




start for UNIX System 










* 


Release 3.0*/ 


#define 


E 


GORT 


oil 


/* 


start for UNIX system/RT */ 


#define 


E. 


STOP 


012 


/• 


stop */ 


#define 


E. 


TCHG 


013 


/* 


time change •/ 


#define 


E. 


CCHG 


014 


/* 


configuration change */ 


#define 


E_ 


BLK 


020 


/♦ 


block device error •/ 


#define 


E. 


_STRAY 


030 


/* 


stray interrupt */ 


#define 


E 


PRTY 


031 


/* 


memory parity */ 


#define 


E. 


PIO 


041 


/* 


3B 20 computer programmed 










* 


I/O */ 


#define 


E. 


lOP 


042 




3B 20 computer I/O 










* 


processor •/ 


#define 


E 


_NI 


0100 




NI20 error */ 



Some records in the error file are of an administrative nature. These include 
the startup record that is entered into the file when logging is activated, the 
stop record that is written if the daemon is terminated "gracefully", and the 
time-change record that is used to account for changes in the system's time-of- 
day. These records have the following formats: 

struct estart { 



short 

struct utsname 
#ifndef u3b 

short 

long 

short 
#endif 
#ifdef u3b 

int 
#endif 



e cpu; /* CPU type »/ 

e_name; /* system names */ 

e_mmr3; /• contents mem mgmt reg 3 */ 

e syssize; /* 11/70 system memory size ♦/ 

e_bconf; /• block dev configuration */ 



e mmcnt; /* kbytes per array */ 



#define eend errhdr /* record header */ 
struct etimchg { 



time t 



e ntime; 



/• new time */ 
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Stray interrupts cause a record with the following format to be logged: 

struct estray { 
#ifdef u3b 

uint e_saddr; /* stray loc or device addr */ 

#else 

physadr e_saddr; /* stray loc or device addr */ 

short e_sbacty; /* active block devices */ 

#endif 

}; 

Memory subsystem error on 3B 20 computer and VAX 11/70 processor cause 
the following record to be generated: 

struct eparity { 
#ifdef u3b 

int e_parreg[3]; /* 3B computer memory 

* registers */ 

#else 

short ejparreg[4]; /* memory subsys registers */ 

#endif 
}; 

Memory subsystem errors on VAX- 11/780 processors cause the following record 
to be generated: 

struct ememory { 

int e_sbier; 
int ememcad; 

}; 

Error records for block devices have the following format: 

struct eblock { 
#ifdef u3b 



ushort 


e_num; 


/* 


device number */ 


struct iostat { 








long 


loops; 


/* 


number read/writes */ 


long 


iomisc; 


/* 


number "other" operations */ 


ushort 


io_unlog; 


/* 


number unlogged errors */ 


} 


e_stats; 






short 


e_bflags; 


/* 


read/write, error, etc */ 


daddrj 


e_bnum; 


/* 


logical block number */ 


uint 


e_bytes; 


/* 


number bytes to transfer */ 


union ptbl { 








int page[64]; 


/* 


page table entries */ 


union ptbl 


*pnext; 






} 


e_ptbl; 






struct ptbl 


e_ptbl; 


/* 


page table for transfer */ 


uint 


e_voff; 


/* 


offset into page table */ 


uint 


estat 1 ; 


/* 


status word 1 */ 


uint 


e_stat2; 


/* 


status word 2 */ 



#endif 
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#ifndef u3b 








dev_t 


edev; 


/* 


"true" major + minor dev no */ 


physadr 


e_regloc; 


/* 


controller address */ 


short 


e_bacty; 


/* 


other block I/O activity */ 


struct iostat { 








long 


io_ops; 


/* 


number read/writes */ 


long 


io_misc; 


/* 


number "other" operations */ 


ushort 


iounlog; 


/* 


number unlogged errors */ 


} 


e_stats; 






short 


e_bf[ags; 


/* 


read/write, error, etc ♦/ 


short 


e_cyloff; 


/* 


logical dev start cyl */ 


daddrt 


e_bnum; 


/* 


logical block number */ 


ushort 


e_bytes; 


/* 


number bytes to transfer */ 


paddr_t 


ememadd; 


/* 


buffer memory address */ 


ushort 


e_rtry; 


/* 


number retries */ 


short 


enreg; 


/* 


number device registers */ 



#endif 
#ifdef vax 

struct mba_regs I 

long mba_csr; 

long mba cr; 

long mba_sr; 

long mba_var; 

long mba vcr; 
} e_mba; 
#endif 



The following values are used in the ej>flags word: 



#define E WRITE 


0 


/* 


write operation */ 


#define E_READ 


1 


/* 


read operation */ 


#define E_NOIO 


02 


/* 


no I/O pending ♦/ 


#define E PHYS 


04 


/* 


physical I/O */ 


#define E_MAP 


010 


/* 


Unibus map in use */ 


#define E_ERROR 


020 


/* 


I/O failed */ 



The following error records are for the 3B 20 computer only: 

/* programmed I/O (pio) error */ 
/* which channel */ 
/* which dev on channel */ 



struct epio 
char 
char 
uint 
uint 



e_chan; 
edev; 
e_chstat; 
e cmd; 



/* channel status */ 
/* pio command */ 



struct eiop { 

char eunit; 

uint ewordO; 

uint eword 1 ; 



/* I/O processor (iop) error ♦/ 
/* unit number */ 
/♦ iop report word */ 
/* iop report word */ 
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The "true" major device numbers that identify the failing device are as follows: 



Digital 


Equipment 


AT&T Technologies 


fFdenne 


RKO 


0 


fFCieiine DFCU u 


fFdenne 


RPO 


1 


ffdeiine lOPU 1 


fFderine 


RFO 


2 


fFdenne MTU 2 


#define 


TMO 


3 




#define 


TCO 


4 




#define 


HPO 


5 




#define 


HTO 


6 




#define 


HSO 


7 




#define 


RLO 


8 




#define 


HPl 


9 




#define 


HP2 


10 




#define 


HP3 


11 





SEE ALSO 

errdemon(lM) in the UNIX System V Administrator Reference Manual. 
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NAME 

filehdr — file header for common object files 

SYNOPSIS 

#include <filehdr.h> 

DESCRIPTION 

Every common object file begins with a 20-byte header. The following C struct 
declaration is used: 

struct filehdr 
{ 

unsigned short f_magic ; /* magic number */ 
unsigned short f_nscns ; /* number of sections */ 
long f_timdat ; /* time & date stamp */ 

long f_symptr ; /* file ptr to symtab */ 

long f_nsyms ; /* # symtab entries */ 

unsigned short f_opthdr ; /* sizeof(opt hdr) •/ 
unsigned short f_flags ; /* flags •/ 

} ; 

F_symptr is the byte offset into the file at which the symbol table can be found. 
Its value can be used as the offset in fseekOS) to position an I/O stream to the 
symbol table. The UNIX system optional header is 36 bytes on the 3B 20 com- 
puter, 28 bytes otherwise. The valid magic numbers are given below: 

#define N3BMAGIC 0550 /* 3B 20 computer */ 
#define NTVMAGIC 0551 /* 3B 20 computer •/ 



#define VAXWRMAGIC 0570 
#define VAXROMAGIC 0575 

The value in f jimdat is obtained from 
currently defined are: 



#define 


F RELFLG 


00001 


/* 


#define 


FEXEC 


00002 


/* 


#define 


F LNNO 


00004 


/* 


#define 


FLSYMS 


00010 


/* 


#define 


F MINMAL 00020 


/* 


#define 


F UPDATE 


00040 


/* 


#define 


FSWABD 


00100 


/* 


#define 


F AR16WR 


00200 


/* 


#define 


F_AR32WR 


00400 


/* 


#define 


F_AR32W 


01000 


/* 


#define 


F PATCH 


02000 


/* 



/* VAX writable text segments ♦/ 

/* VAX readonly sharable text segments */ 

the timed) system call. Flag bits 

relocation entries stripped */ 
file is executable */ 
line numbers stripped */ 
local symbols stripped */ 
minimal object file */ 
update file, ogen produced */ 
file is "pre-swabbed" */ 
16 bit DEC host */ 
32 bit DEC host */ 
non-DEC host */ 
"patch" list in opt hdr */ 



SEE ALSO 

time(2), fseek(3S), a.out(4). 
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NAME 

file system — format of system volume 

SYNOPSIS 

#include <sys/filsys.h> 
#include <sys/types.h> 
#include <sys/parain.h> 

DESCRIPTION 

Every file system storage volume has a common format for certain vital infor- 
mation. Every such volume is divided into a certain number of 512-byte long 
sectors. Sector 0 is unused and is available to contain a bootstrap program or 
other information. 

Sector 1 is the super -block. The format of a super-block is: 
/» 

* Structure of the super-block 
*/ 



filsys 








ushort 


sisize; 


/• 


size in blocks of i-list */ 


daddrt 


s_fsize; 


/• 


size in blocks of entire volume •/ 


short 


s_nfree; 


/* 


number of addresses in s_free */ 


UdUUr I 




/ * 


free block list */ 


short 


sninode; 


/* 


number of i-nodes in s inode */ 


inot 


sinodelNICINOD]; 


/• 


free i-node list */ 


char 


sflock; 


/• 


lock during free list manipulation */ 


char 


sjlock; 


/• 


lock during i-list manipulation */ 


char 


sfmod; 


/• 


super block modified flag */ 


char 


sronly; 


/• 


mounted read-only flag */ 


timet 


s_time; 


/• 


last super block update »/ 


short 


s_dinfo[4]; 


/* 


device information */ 


daddrt 


s_tfree; 


/• 


total free blocks*/ 


inot 


stinode; 


/* 


total free i-nodes */ 


char 


s_fnamet6]; 


/* 


file system name */ 


char 


s_fpack[6]; 


/• 


file system pack name ♦/ 


long 


sjill[l3]; 


/• 


ADJUST to make sizeof filsys be 512 »/ 


long 


smagic; 


/* 


magic number to denote new file system •/ 


long 


stype; 


/• 


type of new file system •/ 


FsMAGIC 


Oxfdl87e20 


/• 


s magic number */ 


Fslb 


1 


/* 


5 1 2 byte block •/ 


Fs2b 


2 


/* 


1024 byte block */ 



Sjype indicates the file system type. Currently, two types of file systems are 
supported: the original 512-byte oriented and the new improved 1024-byte 
oriented. S magic is used to distinguish the original 512-byte oriented file sys- 
tems from the newer file systems. If this field is not equal to the magic 
number, FsMAGIC, the type is assumed to be Fslb, otherwise the sjype field 
is used. In the following description, a block is then determined by the type. 
For the original 512-byte oriented file system, a block is 512 bytes. For the 
1024-byte oriented file system, a block is 1024 bytes or two sectors. The 
operating system takes care of all conversions from logical block numbers to 
physical sector numbers. 

SJsize is the address of the first data block after the i-list; the i-list starts just 
after the super-block, namely in block 2; thus the i-list is sJsize—1 blocks long. 
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5 Jsize is the first block not potentially available for allocation to a file. These 
numbers are used by the system to check for bad block numbers; if an "impos- 
sible" block number is allocated from the free list or is freed, a diagnostic is 
written on the on-line console. Moreover, the free array is cleared, so as to 
prevent further allocation from a presumably corrupted free list. 

The free list for each volume is maintained as follows. The 5 J'ree array con- 
tains, in s J'reell], s Jree[s_nfree—\\, up to 49 numbers of free blocks. 
S J'reelO] is the block number of the head of a chain of blocks constituting the 
free list. The first long in each free-chain block is the number (up to 50) of 
free-block numbers listed in the next 50 longs of this chain member. The first 
of these 50 blocks is the link to the next member of the chain. To allocate a 
block: decrement sjifree, and the new block is s Jree[s_nfree]. If the new 
block number is 0, there are no blocks left, so give an error. If s nfree became 
0, read in the block named by the new block number, replace s nfree by its 
first word, and copy the block numbers in the next 50 longs into the sjree 
array. To free a block, check if sjifree is 50; if so, copy s nfree and the s J'ree 
array into it, write it out, and set sjifree to 0. In any event set s Jreelsjifree] 
to the freed block's number and increment s nfree. 

Sjfree is the total free blocks available in the file system. 

Sjiinode is the number of free i-numbers in the sjnode array. To allocate an 
i-node: if sjiinode is greater than 0, decrement it and return 
sJnodeUjtinode]. If it was 0, read the i-list and place the numbers of all free 
i-nodes (up to 100) into the sjnode array, then try again. To free an i-node, 
provided sjiinode is less than 100, place its number into s inodels ninode] and 
increment sjiinode. If sjiinode is already 100, do not bother to enter the 
freed i-node into any table. This list of i-nodes is only to speed up the alloca- 
tion process; the information as to whether the i-node is really free or not is 
maintained in the i-node itself. 

Sjinode is the total free i-nodes available in the file system. 

S Jiock and sjlock are flags maintained in the core copy of the file system 
while it is mounted and their values on disk are immaterial. The value of 
s Jmod on disk is likewise immaterial; it is used as a flag to indicate that the 
super-block has changed and should be copied to the disk during the next 
periodic update of file system information. 

Sjonly is a read-only flag to indicate write-protection. 

Sjime is the last time the super-block of the file system was changed, and is 
the number of seconds that have elapsed since 00:00 Jan. 1, 1970 (GMT). 
During a reboot, the sJime of the super-block for the root file system is used to 
set the system's idea of the time. 

S Jname is the name of the file system and s Jpack is the name of the pack. 

I-numbers begin at 1, and the storage for i-nodes begins in block 2. Also, i- 
nodes are 64 bytes long. I-node 1 is reserved for future use. I-node 2 is 
reserved for the root directory of the file system, but no other i-number has a 
built-in meaning. Each i-node represents one file. For the format of an i-node 
and its flags, see inodeiA). 

FILES 

/ usr/include/sys/filsys.h 
/usr/include/sys/stat.h 

SEE ALSO 

inode(4). 

fsck(lM), fsdb(lM), mkfs(lM) in the UNIX System V Administrator Refer- 
ence Manual. 
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NAME 

fspec — format specification in text files 
DESCRIPTION 

It is sometimes convenient to maintain text files on the UNIX system with non- 
standard tabs, (i.e., tabs which are not set at every eighth column). Such files 
must generally be converted to a standard format, frequently by replacing all 
tabs with the appropriate number of spaces, before they can be processed by 
UNIX system commands. A format specification occurring in the first line of a 
text file specifies how tabs are to be expanded in the remainder of the file. 

A format specification consists of a sequence of parameters separated by blanks 
and surrounded by the brackets <: and :>. Each parameter consists of a 
keyletter, possibly followed immediately by a value. The following parameters 
are recognized: 

ttabs The t parameter specifies the tab settings for the file. The value of 
tabs must be one of the following: 

1. a list of column numbers separated by commas, indicating 
tabs set at the specified columns; 

2. a — followed immediately by an integer n, indicating tabs at 
intervals of n columns; 

3. a — followed by the name of a "canned" tab specification. 

Standard tabs are specified by t— 8, or equivalently, tl,9,17,25,etc. 
The canned tabs which are recognized are defined by the tabs il) 
command. 

ssize The s parameter specifies a maximum line size. The value of size 
must be an integer. Size checking is performed after tabs have 
been expanded, but before the margin is prepended. 

mmargin The m parameter specifies a number of spaces to be prepended to 
each line. The value of margin must be an integer. 

d The d parameter takes no value. Its presence indicates that the 

line containing the format specification is to be deleted from the 
converted file. 

e The e parameter takes no value. Its presence indicates that the 

current format is to prevail only until another format specification 
is encountered in the file. 

Default values, which are assumed for parameters not supplied, are t— 8 and 
mO. If the s parameter is not specified, no size checking is performed. If the 
first line of a file does not contain a format specification, the above defaults are 
assumed for the entire file. The following is an example of a line containing a 
format specification: 

♦ <:t5,10,15 s72:> * 

If a format specification can be disguised as a comment, it is not necessary to 
code the d parameter. 

Several UNIX system commands correctly interpret the format specification for 
a file. Among them is gath (see send i\C)) which may be used to convert files 
to a standard format acceptable to other UNIX system commands. 

SEE ALSO 

ed(l), newform(l), send(lC), tabs(l) in the UNIX System V User Reference 
Manual. 
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NAME 

gettydefs — speed and terminal settings used by getty 
DESCRIPTION 

The /etc/gettydefs file contains information used by getty i\M) to set up the 
speed and terminal settings for a line. It supplies information on what the 
login prompt should look like. It also supplies the speed to try next if the user 
indicates the current speed is not correct by typing a <break> character. 

Each entry in /etc/gettydefs has the following format: 

label# initial-flags # final-flags # login-prompt #next-label 

Each entry is followed by a blank line. The various fields can contain quoted 
characters of the form \b, \n, \c, etc., as well as \nnn, where nnn is the octal 
value of the desired character. The various fields are: 

label This is the string against which getty tries to match its second 

argument. It is often the speed, such as 1200, at which the ter- 
minal is supposed to run, but it need not be (see below) . 

initial -flags These flags are the initial ioctlil) settings to which the terminal 
is to be set if a terminal type is not specified to getty. The flags 
that getty understands are the same as the ones listed in 
/usr/include/sys/terinio.h (see termioil)). Normally only the 
speed flag is required in the initial -flags. Getty automatically 
sets the terminal to raw input mode and takes care of most of 
the other flags. The initial-flag settings remain in eff'ect until 
getty executes loginil). 

final -flags These flags take the same values as the initial -flags and are set 
just prior to getty executes login. The speed flag is again 
required. The composite flag SANE takes care of most of the 
other flags that need to be set so that the processor and terminal 
are communicating in a rational fashion. The other two com- 
monly specified final-flags are TAB3, so that tabs are sent to the 
terminal as spaces, and HUPCL, so that the line is hung up on 
the final close. 

login-prompt This entire field is printed as the login -prompt. Unlike the 
above fields where white space is ignored (a space, tab or new- 
line), they are included in the login-prompt field. 

next -label If this entry does not specify the desired speed, indicated by the 
user typing a <break> character, then getty will search for the 
entry with next-label as its label field and set up the terminal 
for those settings. Usually, a series of speeds are linked together 
in this fashion, into a closed set; For instance, 2400 linked to 
1200, which in turn is linked to 300, which finally is linked to 
2400. 

If getty is called without a second argument, then the first entry of 
/etc/gettydefs is used, thus making the first entry of /etc/gettydefs the default 
entry. It is also used if getty can not find the specified label. If /etc/gettydefs 
itself is missing, there is one entry built into the command which will bring up 
a terminal at 300 baud. 

It is strongly recommended that after making or modifying /etc/gettydefs, it be 
run through getty with the check option to be sure there are no errors. 
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FILES 

/etc/gettydefs 

SEE ALSO 

ioctl(2). 

getty(lM), termio(7) in the UNIX System V Administrator Reference Manual. 
login (1) in the UNIX System V User Reference Manual. 
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NAME 

gps — graphical primitive string, format of graphical files 
DESCRIPTION 

GPS is a format used to store graphical data. Several routines have been 
developed to edit and display GPS files on various devices. Also, higher level 
graphics programs such as plot (in statilG)) and vtoc (in foe (IG)) produce 
GPS format output files. 

A GPS is composed of five types of graphical data or primitives. 
GPS PRIMITIVES 

lines The lines primitive has a variable number of points from which zero 

or more connected line segments are produced. The first point 
given produces a move to that location. (A move is a relocation of 
the graphic cursor without drawing.) Successive points produce line 
segments from the previous point. Parameters are available to set 
color, weight, and style (see below). 

arc The arc primitive has a variable number of points to which a curve 

is fit. The first point produces a move to that point. If only two 
points are included, a line connecting the points will result; if three 
points a circular arc through the points is drawn; and if more than 
three, lines connect the points. (In the future, a spline will be fit to 
the points if they number greater than three.) Parameters are avail- 
able to set color, weight, and style. 

text The text primitive draws characters. It requires a single point 

which locates the center of the first character to be drawn. Param- 
eters are color, font, textsize, and textangle. 

hardware The hardware primitive draws hardware characters or gives control 
commands to a hardware device. A single point locates the begin- 
ning location of the hardware string. 

comment A comment is an integer string that is included in a GPS file but 
causes nothing to be displayed. All GPS files begin with a comment 
of zero length. 

GPS PARAMETERS 

color Color is an integer value set for arc, lines, and text primitives. 

weight Weight is an integer value set for arc and lines primitives to indi- 
cate line thickness. The value 0 is narrow weight, 1 is bold, and 2 
is medium weight. 

style Style is an integer value set for lines and arc primitives to give one 
of the five different line styles that can be drawn on TEKTRONIX 
4010 series storage tubes. They are: 

0 solid 

1 dotted 

2 dot dashed 

3 dashed 

4 long dashed 

font An integer value set for text primitives to designate the text font to 

be used in drawing a character string. (Currently font is expressed 
as a four-bit weight value followed by a four-bit style value.) 

textsize Textsize is an integer value used in text primitives to express the 
size of the characters to be drawn. Textsize represents the height 
of characters in absolute universe -units and is stored at one-fifth 
this value in the size-orientation (so) word (see below) . 
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textangle Textangle is a signed integer value used in text primitives to express 
rotation of the character string around the beginning point. 
Textangle is expressed in degrees from the positive x-axis and can 
be a positive or negative value. It is stored in the size-orientation 
{so) word as a value 256/360 of it's absolute value. 

ORGANIZATION 

GPS primitives are organized internally as follows: 

lines cw points sw 

arc cw points sw 

text cw point sw so [string] 

hardware cw point [string] 

comment cw [string] 

cw Cw is the control word and begins all primitives. It consists of four 

bits that contain a primitive-type code and twelve bits that contain 
the word-count for that primitive. 

point(s) Pointis) is one or more pairs of integer coordinates. Text and 
hardware primitives only require a single point. Pointis) are values 
within a Cartesian plane or universe having 64K (— 32K to +32K) 
points on each axis. 

sw Sw is the style-word and is used in lines, arc, and text primitives. 

For all three, eight bits contain color information. In arc and lines 
eight bits are divided as four bits weight and four bits style. In the 
text primitive eight bits of sw contain the font. 

so So is the size-orientation word used in text primitives. Eight bits 

contain text size and eight bits contain text rotation. 

string String is a null-terminated character string. If the string does not 
end on a word boundary, an additional null is added to the GPS file 
to insure word-boundary alignment. 

SEE ALSO 

graphics (IG), stat(lG), toc(lG) in the UNIX System V User Reference 
Manual. 
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NAME 

group — group file 

DESCRIPTION 

Group contains for each group the following information: 

group name 
encrypted password 
numerical group ID 

comma-separated list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; each group is 
separated from the next by a new-line. If the password field is null, no pass- 
word is demanded. 

This file resides in directory /etc. Because of the encrypted passwords, it can 
and does have general read permission and can be used, for example, to map 
numerical group ID's to names. 

FILES 

/etc/group 

SEE ALSO 

crypt (3 C), passwd(4). 

newgrp(l), passwd(l) in the UNIX System V User Reference Manual. 
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NAME 

inittab — script for the init process 
DESCRIPTION 

The inittab file supplies the script to />i/7's role as a general process dispatcher. 
The process that constitutes the majority of init's process dispatching activities 
is the line process /etc/getty that initiates individual terminal lines. Other 
processes typically dispatched by init are daemons and the shell. 

The inittab file is composed of entries that are position dependent and have the 
following format: 

id:rstate:action:process 

Each entry is delimited by a newline, however, a backslash (\) preceding a 
newline indicates a continuation of the entry. Up to 512 characters per entry 
are permitted. Comments may be inserted in the process field using the shil) 
convention for comments. Comments for lines that spawn gettys are displayed 
by the who(\) command. It is expected that they will contain some informa- 
tion about the line such as the location. There are no limits (other than max- 
imum entry size) imposed on the number of entries within the inittab file. The 
entry fields are: 

id This is one or two characters used to uniquely identify an entry. 

rstate This defines the run-level in which this entry is to be processed. 

Run- levels effectively correspond to a configuration of processes in the 
system. That is, each process spawned by init is assigned a run-level 
or run-levels in which it is allowed to exist. The run-levels are 
represented by a number ranging from 0 through 6. As an example, 
if the system is in run- level 1, only those entries having a 1 in the 
rstate field will be processed. When init is requested to change run- 
levels, all processes which do not have an entry in the rstate field for 
the target run- level will be sent the warning signal (SIGTERM) and 
allowed a 20-second grace period before being forcibly terminated by 
a kill signal (SIGKILL). The rstate field can define multiple run- 
levels for a process by selecting more than one run-level in any com- 
bination from 0—6. If no run- level is specified, then the process is 
assumed to be vahd at all run- levels 0—6. There are three other 
values, a, b and c, which can appear in the rstate field, even though 
they are not true run-levels. Entries which have these characters in 
the rstate field are processed only when the telinit (see initilM)) pro- 
cess requests them to be run (regardless of the current run- level of 
the system). They differ from run-levels in that init can never enter 
run- level a, b or c. Also, a request for the execution of any of these 
processes does not change the current run-level. Furthermore, a pro- 
cess started by an a, b or c command is not killed when init changes 
levels. They are only killed if their line in /etc/inittab is marked off 
in the action field, their line is deleted entirely from /etc/inittab, or 
init goes into the SINGLE USER state. 

action Key words in this field tell init how to treat the process specified in 
the process field. The actions recognized by init are as follows: 

respawn If the process does not exist then start the process, do not 
wait for its termination (continue scanning the inittab 
file), and when it dies restart the process. If the process 
currently exists then do nothing and continue scanning 
the inittab file. 



INITTAB(4) 



INITTAB(4) 



wait 



once 



boot 



bootwait 

powerfail 
powerwait 

off 

ondemand 
initdefault 



Upon init's entering the run-level that matches the 
entry's rstate, start the process and wait for its termina- 
tion. All subsequent reads of the inittab file while init is 
in the same run-level will cause init to ignore this entry. 

Upon iniVs entering a run-level that matches the entry's 
rstate, start the process, do not wait for its termination. 
When it dies, do not restart the process. If upon entering 
a new run-level, where the process is still running from a 
previous run-level change, the program will not be res- 
tarted. 

The entry is to be processed only at iniVs. boot-time read 
of the inittab file. Init is to start the process, not wait for 
its termination; and when it dies, not restart the process. 
In order for this instruction to be meaningful, the rstate 
should be the default or it must match in/7's run-level at 
boot time. This action is useful for an initialization func- 
tion following a hardware reboot of the system. 

The entry is to be processed only at iniVs boot-time read 
of the inittab file. Init is to start the process, wait for its 
termination and, when it dies, not restart the process. 

Execute the process associated with this entry only when 
init receives a power fail signal (SIGPWR see signal (2)). 

Execute the process associated with this entry only when 
init receives a power fail signal (SIGPWR) and wait until 
it terminates before continuing any processing of inittab. 

If the process associated with this entry is currently run- 
ning, send the warning signal (SIGTERM) and wait 20 
seconds before forcibly terminating the process via the kill 
signal (SIGKILL). If the process is nonexistent, ignore the 
entry. 

This instruction is really a synonym for the respawn 
action. It is functionally identical to respawn but is given 
a different keyword in order to divorce its association with 
run-levels. This is used only with the a, b or c values 
described in the rstate field. 

An entry with this action is only scanned when init ini- 
tially invoked. Init uses this entry, if it exists, to deter- 
mine which run-level to enter initially. It does this by 
taking the highest run-level specified in the rstate field 
and using that as its initial state. If the rstate field is 
empty, this is interpreted as 0123456 and so init will 
enter run- level 6. Also, the initdefault entry cannot 
specify that init start in the SINGLE USER state. Addi- 
tionally, if init does not find an initdefault entry in 
/etc/inittab, then it will request an initial run-level from 
the user at reboot time. 
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sysinit Entries of this type are executed before init tries to access 
the console. It is expected that this entry will be only 
used to initialize devices on which init might try to ask 
the run-level question. These entries are executed and 
waited for before continuing. 

process This is a sh command to be executed. The entire process field is 
prefixed with exec and passed to a forked sh as sh — c 'exec com- 
mand'. For this reason, any legal sh syntax can appear in the process 
field. Comments can be inserted with the ; ^comment syntax. 

FILES 

/etc/inittab 

SEE ALSO 

exec (2), open (2), signal (2). 

getty(lM), init(lM) in the UNIX System V Administrator Reference Manual. 
sh(l), who(l) in the UNIX System V User Reference Manual. 
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NAME 

inode — format of an i-node 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/ino.h> 

DESCRIPTION 

An i-node for a plain file or directory in a file system has the following struc- 
ture defined by <sys/ino.h>. 

/» Inode structure as it appears on a disk block. */ 

struct dinode 

{ 

ushort di mode; /* mode and type of file */ 

short di nlink; /* number of links to file ♦/ 

ushort di uid; /• owner's user id •/ 

ushort di_gid; /♦ owner's group id */ 

off t di_size; /* number of bytes in file •/ 

char di_addr[40]; /* disk block addresses ♦/ 

time t di_atime; /• time last accessed */ 

time t di mtime; /♦ time last modified •/ 

time t dijctime; /* time of last file status change ♦/ 

/• 

♦ the 40 address bytes: 

• 39 used; 13 addresses 

* of 3 bytes each. 
*/ 

For the meaning of the defined types off J and timet see types (5) . 

FILES 

/usr/include/sys/ino.h 

SEE ALSO 

Stat (2), fs(4), types (5). 
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NAME 

issue — issue identification file 
DESCRIPTION 

The file /etc/issue contains the issue or project identification to be printed as a 
login prompt. This is an ASCII file which is read by program getty and then 
written to any terminal spawned or respawned from the lines file. 

FILES 

/etc/issue 
SEE ALSO 

login (1) in the UNIX System V User Reference Manual. 
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NAME 

Idfcn — common object file access routines 

SYNOPSIS 

#include <stdio.h> 

#include <filehdr.h> 

#include <Idfcn.h> 



DESCRIPTION 

The common object file access routines are a collection of functions for reading 
an object file that is in VAX or 3B 20 computer (common) object file form. 
Although the calling program must know the detailed structure of the parts of 
the object file that it processes, the routines effectively insulate the calling pro- 
gram from knowledge of the overall structure of the object file. 

The interface between the calling program and the object file access routines is 
based on the defined type LDFILE, defined as struct Idfile, declared in the 
header file ldfcn.h. The primary purpose of this structure is to provide uniform 
access to both simple object files and to object files that are members of an 
archive file. 

The function ldopen(.3X) allocates and initializes the LDFILE structure and 
returns a pointer to the structure to the calling program. The fields of the 
LDFILE structure may be accessed individually through macros defined in 
ldfcn.h and contain the following information: 

LDFILE *ldptr; 

TYPE(ldptr) The file magic number used to distinguish between archive 
members and simple object files. 

lOPTR(ldptr) The file pointer returned by fopen and used by the standard 
input/output functions. 

OFFSET(ldptr) The file address of the beginning of the object file; the offset is 
non-zero if the object file is a member of an archive file. 

HEADER (Idptr) The file header structure of the object file. 

The object file access functions themselves may be divided into four categories: 

(1) functions that open or close an object file 

ldopeni3X) and ldopeni3X) 

open a common object file 
ldclose{3X) and IdcloseOX) 

close a common object file 

(2) functions that read header or symbol table information 

IdahreadOX) 

read the archive header of a member of an archive file 
ldfhread(3X) 

read the file header of a common object file 
ldshread(3X) and ldshread{3X) 

read a section header of a common object file 
ldtbread{.3X) 

read a symbol table entry of a common object file 
ldgetname{3X^ 

retrieve a symbol name from a symbol table entry or 

from the string table 

(3) functions that position an object file at (seek to) the start of the 
section, relocation, or line number information for a particular section. 
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IdohseekOX) 

seek to the optional file header of a common object file 
IdsseekiSX) and ldsseek(3X) 

seek to a section of a common object file 
ldrseek(3X) and ldrseek(3X) 

seek to the relocation information for a section of a 

common object file 
ldlseeki3X) and ldlseeki3X) 

seek to the line number information for a section of a 

common object file 
ldtbseek(3X) 

seek to the symbol table of a common object file 

(4) the function ldtbindexi3X) which returns the index of a particular 
common object file symbol table entry. 

These functions are described in detail on their respective manual pages. 

All the functions except ldopen(3X), ldgetname(3X), ldopen(3X), and 
ldtbindexi3X) return either SUCCESS or FAILURE, both constants defined in 
Idfcn.h. Ldopen(3X) and ldopen(3X) both return pointers to an LDFILE struc- 
ture. 

Additional access to an object file is provided through a set of macros defined 
in ldfcn.h. These macros parallel the standard input/output file reading and 
manipulating functions, translating a reference of the LDFILE structure into a 
reference to its file descriptor field. 

The following macros are provided: 

GETC(ldptr) 
FGETC(ldptr) 
GETW(ldptr) 
UNGETC(c, Idptr) 
FGETS(s, n, Idptr) 

FREAD((char ♦) ptr, sizeof (♦ptr), nitems, Idptr) 

FSEEK (Idptr, offset, ptrname) 

FTELL (Idptr) 

REWIND (Idptr) 

FEOF (Idptr) 

FERROR (Idptr) 

FILENO (Idptr) 

SETBUFddptr, buf) 

STROFFSET (Idptr) 

The STROFFSET macro calculates the address of the string table in a UNIX 
system release 5.0 object file. See the manual entries for the corresponding 
standard input/output library functions for details on the use of the rest of the 
macros. 

The program must be loaded with the object file access routine library Iibld.a. 
WARNING 

The macro FSEEK defined in the header file Idfcn.h translates into a call to the 
standard input/output function fseek (3S). FSEEK should not be used to seek 
from the end of an archive file since the end of an archive file may not be the 
same as the end of one of its object file members! 
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SEE ALSO 

fseekOS), IdahreadOX), ldclose(3X), ldgetname(3X), ldfhread(3X), 
ldlread(3X), ldlseek(3X), ldohseek(3X), ldopen(3X), ldrseek(3X), ldlseek(3X), 
ldshread(3X), ldtbindex(3X), ldtbread(3X), ldtbseek(3X). fseek(3S), 
ldahread(3X), ldclose(3X), ldgetname(3X), ldfhrea(l(3X), ldlread(3X), 
ldlseek(3X), ldohseek(3X), ldopen(3X), IdrseekOX), ldlseek(3X), 
ldshread(3X), ldtbindex(3X), ldtbread(3X), ldtbseek(3X), intro(5). 
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NAME 



linenum — line number entries in a common object file 



SYNOPSIS 



#include < linenum.h > 



DESCRIPTION 



Compilers based on pec generate an entry in the object file for each C source 
line on which a breakpoint is possible (when invoked with the — g option; see 
cc{\)). Users can then reference line numbers when using the appropriate 
software test system (see sdbi.\)). The structure of these line number entries 
appears below. 

struct lineno 



Numbering starts with one for each function. The initial line number entry for 
a function has IJnno equal to zero, and the symbol table index of the function's 
entry is in I symndx. Otherwise, IJnno is non-zero, and / _paddr is the physi- 
cal address of the code for the referenced line. Thus the overall structure is the 
following: 



union 



long l_symndx ; 



long Ijpaddr ; 
} l_addr ; 

unsigned short l lnno ; 



} ; 



/ addr 



I Inno 



function symtab index 
physical address 
physical address 



0 

line 
line 



function symtab index 
physical address 
physical address 



0 

line 
line 



SEE ALSO 



a.out(4). 

cc(l), sdb(l) in the UNIX System V User Reference Manual. 
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NAME 

master — master device information table 
DESCRIPTION 

This file is used by the configilM) program to obtain device information that 
enables it to generate the configuration files. The file consists of 3 parts, each 
separated by a line with a dollar sign ($) in column 1. Part 1 contains device 
information; part 2 contains names of devices that have aliases; part 3 contains 
tunable parameter information. Any line with an asterisk (*) in column 1 is 
treated as a comment. 

Part 1 contains lines consisting of at least 10 fields and at most 13 fields, with 
the fields delimited by tabs and/or blanks: 

Field 1: device name (8 chars, maximum). 
Field 2: interrupt vector size (decimal, in bytes). 
Field 3: device mask (octal)— each "on" bit indicates that the 
handler exists: 

000100 initialization handler 

000040 power-failure handler 

000020 open handler 

000010 close handler 

000004 read handler 

000002 write handler 

000001 ioctl handler. 
Field 4: device type indicator (octal): 

000200 allow only one of these devices 

000100 suppress count field in the conf.c file 

000040 suppress interrupt vector 

000020 required device 

000010 block device 

000004 character device 

000002 floating vector 
000001 fixed vector. 

Field 5: handler prefix (4 chars, maximum). 

Field 6: device address size (decimal) . 

Field 7: major device number for block- type device. 

Field 8: major device number for character-type device. 

Field 9: maximum number of devices per controller (decimal). 

Field 10: maximum bus request level (4 through 7). 

Fields 11-13: optional configuration table structure declarations (8 
chars, maximum). 

Part 2 contains lines with 2 fields each: 

Field 1: alias name of device (8 chars, maximum). 
Field 2: reference nanie of device (8 chars, maximum; specified 
in part l). 

Part 3 contains lines with 2 or 3 fields each: 

Field 1: parameter name (as it appears in description file; 20 
chars, maximum) 

Field 2: parameter name (as it appears in the conf.c file; 20 
chars, maximum) 

Field 3: default parameter value (20 chars, maximum; parameter 
* specification is required if this field is omitted) 
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Devices that are not interrupt -driven have an interrupt vector size of zero. 



SEE ALSO 

config(lM) in the UNIX System V Administrator Reference Manual. 
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NAME 

mnttab — mounted file system table 

SYNOPSIS 

#include <innttab.h> 

DESCRIPTION 

Mnttab resides in directory /etc and contains a table of devices, mounted by 
the mount ilM) command, in the following structure as defined by 
<mnttab.h>: 

struct mnttab { 

char mt_dev[32]; 
char mt_filsys[32]; 
short mt_ro_flg; 
timet mttime; 

}; 

Each entry is 70 bytes in length; the first 32 bytes are the null-padded name of 
the place where the special file is mounted; the next 32 bytes represent the 
null-padded root name of the mounted special file; the remaining 6 bytes con- 
tain the mounted special file's read/write permissions and the date on which it 
was mounted. 

The maximum number of entries in mnttab is based on the system parameter 
NMOUNT located in /usr/src/uts/cf/conf.c, which defines the number of allow- 
able mounted special files. 

SEE ALSO 

mount(lM), setmnt(lM) in the UNIX System V Administrator Reference 
Manual. 
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NAME 

passwd — password file 

DESCRIPTION 

Passwd contains for each user the following information: 

login name 
encrypted password 
numerical user ID 
numerical group ID 

GCOS job number, box number, optional GCOS user ID 
initial working directory 
program to use as Shell 

This is an ASCII file. Each field within each user's entry is separated from the 
next by a colon. The GCOS field is used only when communicating with that 
system, and in other installations can contain any desired information. Each 
user is separated from the next by a new-line. If the password field is null, no 
password is demanded; if the Shell field is null, the Shell itself is used. 

This file resides in directory /etc. Because of the encrypted passwords, it can 
and does have general read permission and can be used, for example, to map 
numerical user IDs to names. 

The encrypted password consists of 13 characters chosen from a 64-character 
alphabet (., /, 0—9, A— Z, a— z), except when the password is null, in which 
case the encrypted password is also null. Password aging is effected for a par- 
ticular user if his encrypted password in the password file is followed by a 
comma and a non-null string of characters from the above alphabet. (Such a 
string must be introduced in the first instance by the super-user.) 

The first character of the age, M say, denotes the maximum number of weeks 
for which a password is valid. A user who attempts to login after his password 
has expired will be forced to supply a new one. The next character, m say, 
denotes the minimum period in weeks which must expire before the password 
may be changed. The remaining characters define the week (counted from the 
beginning of 1970) when the password was last changed. (A null string is 
equivalent to zero.) M and m have numerical values in the range 0—63 that 
correspond to the 64-character alphabet shown above (i.e., / = 1 week; z = 63 
weeks) . If w = M = 0 (derived from the string . or ..) the user will be forced 
to change his password the next time he logs in (and the "age" will disappear 
from his entry in the password file). If w > M (signified, e.g., by the string 
./) only the super-user will be able to change the password. 

FILES 

/etc/passwd 
SEE ALSO 

a641(3C), crypt(3C), getpwent(3C), group(4). 

login (1), passwd(l) in the UNIX System V User Reference Manual. 
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NAME 

plot — graphics interface 
DESCRIPTION 

Files of this format are produced by routines described in plot(3X) and are 
interpreted for various devices by conimands described in tplot i\G). A graph- 
ics file is a stream of plotting instructions. Each instruction consists of an 
ASCII letter usually followed by bytes of binary information. The instructions 
are executed in order. A point is designated by four bytes representing the x 
and y values; each value is a signed integer. The last designated point in an 1, 
m, n, or p instruction becomes the "current point" for the next instruction. 

Each of the following descriptions begins with the name of the corresponding 
routine in plotiSX). 

m move: The next four bytes give a new current point. 

n cont: Draw a line from the current point to the point given by the next four 
bytes. See tplot i\G). 

p point: Plot the point given by the next four bytes. 

1 line: Draw a line from the point given by the next four bytes to the point 
given by the following four bytes. 

t label: Place the following ASCII string so that its first character falls on the 
current point. The string is terminated by a new-line. 

e erase: Start another frame of output. 

f linemod: Take the following string, up to a new-line, as the style for draw- 
ing further lines. The styles are "dotted", "solid", "longdashed", "short- 
dashed", and "dotdashed". Effective only for the — T4014 and —Tver 
options of tplot iXG) (TEKTRONIX 4014 terminal and Versatec plotter). 

s space: The next four bytes give the lower left corner of the plotting area; 
the following four give the upper right corner. The plot will be magnified or 
reduced to fit the device as closely as possible. 

Space settings that exactly fill the plotting area with unity scaling appear below 
for devices supported by the filters of tplot {IG). The upper limit is just outside 
the plotting area. In every case the plotting area is taken to be square; points 
outside may be displayable on devices whose face is not square. 

DASI 300 space (0, 0, 4096, 4096); 

DASI 300s space(0, 0, 4096, 4096); 

DASI 450 space(0, 0, 4096, 4096); 

TEKTRONIX 4014 space (0, 0, 3120, 3120); 
Versatec plotter space(0, 0, 2048, 2048); 

SEE ALSO 

plot(3X), gps(4), term(5). 

graph (IG), tplot (IG) in the UNIX System V User Reference Manual. 
WARNING 

The plotting library ploti3X) and the curses library curses OX) both use the 
names erase 0 and moveO. The curses versions are macros. If you need both 
libraries, put the plot i3X) code in a different source file than the curses i3X) 
code, and/or #undef moveO and eraseO in the ploti3X) code. 
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NAME 

pnch — file format for card images 
DESCRIPTION 

The PNCK format is a convenient representation for files consisting of card 
images in an arbitrary code. 

A PNCH file is a simple concatenation of card records. A card record consists 
of a single control byte followed by a variable number of data bytes. The con- 
trol byte specifies the number (which must lie in the range 0-80) of data bytes 
that follow. The data bytes are 8-bit codes that constitute the card image. If 
there are fewer than 80 data bytes, it is understood that the remainder of the 
card image consists of trailing blanks. 
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NAME 



profile — setting up an environment at login time 



DESCRIPTION 

If your login directory contains a file named .profile, that file will be executed 
(via exec .profile) before your session begins; .profiles are handy for setting 
exported environment variables and terminal modes. If the file /etc/profile 
exists, it will be executed for every user before the .profile. The following 
example is typical (except for the comments): 

# Make some environment variables global 
export MAIL PATH TERM 

# Set file creation mask 
umask 22 

# Tell me when new mail comes in 
M AIL=/ usr/ mail/myname 

# Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME/bin 

# Set terminal type 
echo "terminal: \c" 
read TERM 

case STERM in 
300) 
300s) 
450) 
hp) 

745 I 735) 
43) 

4014 I tek) 
•) 

esac 



stty cr2 nlO tabs; tabs;; 

stty cr2 nlO tabs; tabs;; 

stty cr2 nlO tabs; tabs;; 

stty crO nlO tabs; tabs;; 

stty crl nil -tabs; TERM=745;; 

stty crl nlO —tabs;; 

stty crO nlO -tabs ffl; TERM=4014; echo '\33;";. 
echo "STERM unknown";; 



FILES 



SHOME/.profile 
/etc/profile 



SEE ALSO 

environ (5), term (5). 

env(l), login(l), mail(l), sh(l), stty(l), su(l) in the UNIX System V User 
Reference Manual. 
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NAME 

reloc — relocation information for a common object file 

SYNOPSIS 

#include <reIoc.h> 

DESCRIPTION 

Object files have one relocation entry for each relocatable reference in the text 
or data. If relocation information is present, it will be in the following format. 

struct reloc 
{ 

long r_vaddr ; /* (virtual) address of reference */ 

long r symndx ; /* index into symbol table */ 

short r type ; /* relocation type */ 

} ; 



/* 

* All generics 

* reloc. already performed to symbol in the same section 
*/ 

#define R_ABS 0 
/* 

* 3B computer generic 

* 24-bit direct reference 

* 24-bit "relative" reference 

* 16-bit optimized "indirect" TV reference 

* 24-bit "indirect" TV reference 

* 32-bit "indirect" TV reference 
•/ 

#define R_DIR24 04 

#define R_REL24 05 

#defme R_OPT16 014 

#define R_IND24 015 

#define R IND32 016 



* DEC Processors VAX 11/780 and VAX 11/750 



* 

*/ 

#define R_RELB YTE 0 1 7 

#define R_RELWORD 020 

#define R_RELLONG 021 

#derme R_PCRBYTE 022 

#defme R_PCRWORD 023 

#derme R_PCRLONG 024 



I 
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As the link editor reads each input section and performs relocation, the reloca- 
tion entries are read. They direct how references found within the input section 
are treated. 

R_ABS The reference is absolute, and no relocation is necessary. The 

entry will be ignored. 

R_DIR24 A direct, 24-bit reference to a symbol's virtual address. 

R_REL24 A "PC-relative", 24-bit reference to a symbol's virtual address. 

Relative references occur in instructions such as jumps and calls. 
The actual address used is obtained by adding a constant to the 
value of the program counter at the time the instruction is exe- 
cuted. 

R_0PT16 An optimized, indirect, 16-bit reference through a transfer vector. 

The instruction contains the offset into the transfer vector table to 
the transfer vector where the actual address of the referenced 
word is stored. 

R_IND24 An indirect, 24-bit reference through a transfer vector. The 
instruction contains the virtual address of the transfer vector, 
where the actual address of the referenced word is stored. 

R_IND32 An indirect, 32-bit reference through a transfer vector. The 
instruction contains the virtual address of the transfer vector, 
where the actual address of the referenced word is stored. 

R_RELBYTE A direct 8-bit reference to a symbol's virtual address. 

R_RELWORD 

A direct 16-bit reference to a symbol's virtual address. 

R_RELLONG 

A direct 32-bit reference to a symbol's virtual address. 
R PCRBYTE A "PC-relative", 8-bit reference to a symbol's virtual address. 
R_PCRWORD 

A "PC-relative", 16-bit reference to a symbol's virtual address. 

R_PCRLONG 

A "PC-relative", 32-bit reference to a symbol's virtual address. 

On the VAX processors relocation of a symbol index of -1 indicates that the 
relative difference between the current segment's start address and the 
program's load address is added to the relocatable address. 

Other relocation types will be defined as they are needed. 

Relocation entries are generated automatically by the assembler and automati- 
cally utilized by the link editor. A link editor option exists for removing the 
relocation entries from an object file. 

SEE ALSO 

a.out(4), syms(4). 

ld(l), strip(l) in the UNIX System V User Reference Manual. 
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NAME 

sccsfile - format of SCCS file 
DESCRIPTION 

An SCCS file is an ASCII file. It consists of six logical parts: the checksum, the 
delta table (contains information about each delta), user names (contains 
login names and/or numerical group IDs of users who may add deltas), flags 
(contains definitions of internal keywords), comments (contains arbitrary 
descriptive information about the file), and the body (contains the actual text 
lines intermixed with control lines). 

Throughout an SCCS file there are lines which begin with the ASCII SOH (start 
of heading) character (octal 001). This character is hereafter referred to as 
the control character and will be represented graphically as @. Any line 
described below which is not depicted as beginning with the control character is 
prevented from beginning with the control character. 

Entries of the form DDDDD represent a five-digit string (a number between 
00000 and 99999). 

Each logical part of an SCCS file is described in detail below. 
Checksum 

The checksum is the first line of an SCCS file. The form of the line is: 
@hDDDDD 

The value of the checksum is the sum of all characters, except those of 
the first line. The @h provides a magic number of (octal) 064001. 

Delta table 

The delta table consists of a variable number of entries of the form: 

@S DDDDD/DDDDD/DDDDD 

@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 

@i DDDDD ... 

@x DDDDD ... 

@g DDDDD ... 

@in <MR nuinber> 



@c < comments > ... 



@e 

The first line (@s) contains the number of lines 
inserted/deleted/unchanged, respectively. The second line (@d) con- 
tains the type of the delta (currently, normal: D, and removed: r), the 
SCCS ID of the delta, the date and time of creation of the delta, the 
login name corresponding to the real user ID at the time the delta was 
created, and the serial numbers of the delta and its predecessor, respec- 
tively. 

The @i, @x, and @g lines contain the serial numbers of deltas 
included, excluded, and ignored, respectively. These lines are optional. 

The @m lines (optional) each contain one MR number associated with 
the delta; the @c lines contain comments associated with the delta. 
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The @e line ends the delta table entry. 
User names 

The list of login names and/or numerical group IDs of users who may 
add deltas to the file, separated by new-lines. The lines containing 
these login names and/or numerical group IDs are surrounded by the 
bracketing lines @u and @U. An empty list allows anyone to make a 
delta. Any line starting with a ! prohibits the succeeding group or user 
from making deltas. 

Flags 

Keywords used internally (see admin il) for more information on their 
use). Each flag line takes the form: 



@f <flag> < optional text> 



The following flags are defined: 



@f t 


<type of program > 


@f V 


< program name> 


@f i 


< keyword string > 


@f b 




@f m 


< module name> 


@f f 


< floor > 


@f c 


< ceiling > 


@f d 


<default-sid> 


@f n 




@f j 




@f 1 


< lock-releases > 


@f q 


<user defined > 


@f z 


< reserved for use in 



The t flag defines the replacement for the %Y% identification keyword. 
The V flag controls prompting for MR numbers in addition to com- 
ments; if the optional text is present it defines an MR number validity 
checking program. The i flag controls the warning/error aspect of the 
"No id keywords" message. When the i flag is not present, this mes- 
sage is only a warning; when the i flag is present, this message will 
cause a "fatal" error (the file will not be gotten, or the delta will not 
be made). When the b flag is present the — b key letter may be used 
on the get command to cause a branch in the delta tree. The m flag 
defines the first choice for the replacement text of the %M% 
identification keyword. The f flag defines the "floor" release; the 
release below which no deltas may be added. The c flag defines the 
"ceiling" release; the release above which no deltas may be added. 
The d flag defines the default SID to be used when none is specified on 
a get command. The n flag causes delta to insert a "null" delta (a 
delta that applies no changes) in those releases that are skipped when 
a delta is made in a new release (e.g., when delta 5.1 is made after 
delta 2.7, releases 3 and 4 are skipped). The absence of the n flag 
causes skipped releases to be completely empty. The j flag causes get 
to allow concurrent edits of the same base SID. The I flag defines a list 
of releases that are locked against editing igetil) with the — e 
keyletter). The q flag defines the replacement for the %Q% 
identification keyword. The z flag is used in certain specialized inter- 
face programs. 
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Comments 

Arbitrary text is surrounded by the bracketing lines @t and @T. The 
comments section typically will contain a description of the file's pur- 
pose. 

Body 

The body consists of text lines and control lines. Text lines do not 
begin with the control character, control lines do. There are three 
kinds of control lines: insert, delete, and end, represented by: 

@I DDDDD 
@D DDDDD 
@E DDDDD 

respectively. The digit string is the serial number corresponding to the 
delta for the control line. 

SEE ALSO 

admin(l), delta(l), get(l), prs(l) in the UNIX System V User Reference 
Manual. 

Source Code Control System User Guide in the UNIX System V User Guide. 
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NAME 

scnhdr — section header for a common object file 

SYNOPSIS 

#include < scnhdr.h > 

DESCRIPTION 

Every common object file has a table of section headers to specify the layout of 
the data within the file. Each section within an object file has its own header. 
The C structure appears below. 



struct scnhdr 
{ 

char 
long 
long 
long 
long 
long 
long 

unsigned 
unsigned 
long 



short 
short 



s_name[SYMNMLEN]; /* section name ♦/ 

s_paddr; /* physical address */ 

s vaddr; /« virtual address */ 

s_size; /♦ section size */ 

s scnptr; /* file ptr to raw data */ 

s relptr; /♦ file ptr to relocation */ 

s lnnoptr; / * file ptr to line numbers */ 

s_nreloc; /* # reloc entries */ 

s_nlnno; /* # line number entries */ 

s_flags; /♦ flags */ 



File pointers are byte offsets into the file; they can be used as the offset in a 
call to /seek {3S). If a section is initialized, the file contains the actual bytes. 
An uninitialized section is somewhat different. It has a size, symbols defined in 
it, and symbols that refer to it. But it can have no relocation entries, line 
numbers, or data. Consequently, an uninitialized section has no raw data in the 
object file, and the values for s scnptr, s relptr, sjnnoptr, s nreloc, and 
s nlnno are zero. 

SEE ALSO 

fseekOS), a.out(4). 

ld(l) in the UNIX System V User Reference Manual. 
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NAME 



syms — common object file symbol table format 

SYNOPSIS 

#include <syins.h> 

DESCRIPTION 

Common object files contain information to support symbolic software testing 
(see sdb{\)). Line number entries, linenumiA), and extensive symbolic infor- 
mation permit testing at the C source level. Every object file's symbol table is 
organized as shown below. 



File name 1. 

Function 1. 

Local symbols for function 1 . 
Function 2. 

Local symbols for function 2. 

Static externs for file 1. 

File name 2. 

Function 1. 

Local symbols for function 1 . 
Function 2. 

Local symbols for function 2. 

Static externs for file 2. 



Defined global symbols. 
Undefined global symbols. 



The entry for a symbol is a fixed-length structure. The members of the struc- 
ture hold the name (null padded), its value, and other information. The C 
structure is given below. 

#define SYMNMLEN 8 
#define FILNMLEN 14 

struct syment 



union 



/* all ways to get symbol name */ 



char - 
struct 



n_name[SYMNMLEN]; /♦ symbol name */ 



long 
long 



n_zeroes; 
noffset; 



/• == OL when in string table */ 
/* location of name in table */ 



} _n_n; 
char 



*_n_nptr[2]; /* allows overlaying */ 



char 
char 



unsigned short 



long 
short 



nvalue; 
n_scnum; 
n_type; 
nsclass; 



n_numaux; 



/* value of symbol */ 

/* section number */ 

/* type and derived type */ 

/* storage class */ 

/* number of aux entries */ 



}; 



#define n name 



n. n name 
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#define n zeroes 
#define n offset 
#define n nptr 



_n._n_n._n_zeroes 
_n ._n_n . _n_of f set 
n._n_nptr[ 1 1 



Meaningful values and explanations for them are given in both syms.h and 
Common Object File Format. Anyone who needs to interpret the entries 
should seek more information in these sources. Some symbols require more 
information than a single entry; they are followed by auxiliary entries that are 
the same size as a symbol entry. The format follows. 

union auxent 



struct 



long 
union 



xtagndx; 



struct 



} X Insz; 



long 
] x misc; 
union 



unsigned short x lnno; 
unsigned short x size; 

X fsize; 



struct 
{ 



struct 



long 
long 
X fen; 



xlnnoptr; 
X endndx; 



unsigned short 
} x_sym; 
struct 
{ 

char x_fname[FILNMLEN]; 
} x_rile; 
struct 



unsigned short x_dimen[DIMNUM]; 
x_ary; 
x_fcnary; 
x_tvndx; 



long xscnlen; 
unsigned short x nreloc; 
unsigned short x_nlinno; 
xscn; 



struct 
{ 

long xjvfill; 
unsigned short x tvlen; 
unsigned short x_tvran[2l; 
} X tv; 

}; 
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Indexes of symbol table entries begin at zero. 

SEE ALSO 

a.out(4), linenum(4). 

sdb(l) in the UNIX System V User Reference Manual. 
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NAME 

term — format of compiled term file. 

SYNOPSIS 
term 

DESCRIPTION 

Compiled terminfo descriptions are placed under the directory 
/usr/lib/terminfo. In order to avoid a linear search of a huge UNIX system 
directory, a two-level scheme is used: /usr/Iib/terminfo/c/name where name is 
the name of the terminal, and c is the first character of name. Thus, act 4 can 
be found in the file /usr/Iib/terininfo/a/act4. Synonyms for the same terminal 
are implemented by multiple links to the same compiled file. 

The format has been chosen so that it will be the same on all hardware. An 8 
or more bit byte is assumed, but no assumptions about byte ordering or sign 
extension are made. 

The compiled file is created with the compile program, and read by the routine 
setupterm. Both of these pieces of software are part of curses(3yi). The file is 
divided into six parts: the header, terminal names, boolean flags, numbers, 
strings, and string table. 

The header section begins the file. This section contains six short integers in 
the format described below. These integers are (l) the magic number (octal 
0432); (2) the size, in bytes, of the names section; (3) the number of bytes in 
the boolean section; (4) the number of short integers in the numbers section; 
(5) the number of offsets (short integers) in the strings section; (6) the size, in 
bytes, of the string table. 

Short integers are stored in two 8-bit bytes. The first byte contains the least 
significant 8 bits of the value, and the second byte contains the most significant 
8 bits. (Thus, the value represented is 256*second-l-first.) The value —1 is 
represented by 0377, 0377, other negative value are illegal. The —1 generally 
means that a capability is missing from this terminal. 



The terminal names section comes next. It contains the first line of the ter- 
minfo description, listing the various names for the terminal, separated by the f 
character. The section is terminated with an ASCII NUL character. 

The boolean flags have one byte for each flag. This byte is either 0 or 1 as the 
flag is present or absent. The capabilities are in the same order as the file 
<term.h>. 

Between the boolean section and the number section, a null byte will be 
inserted, if necessary, to ensure that the number section begins on an even byte. 
All short integers are aligned on a short word boundary. 

The numbers section is similar to the flags section. Each capability takes up 
two bytes, and is stored as a short integer. If the value represented is —1, the 
capability is taken to be missing. 

The strings section is also similar. Each capability is stored as a short integer, 
in the format above. A value of —1 means the capability is missing. Other- 
wise, the value is taken as an ofl'set from the beginning of the string table. 
Special characters in 'X or \c notation are stored in their interpreted form, not 
the printing representation. Padding information $<nn> and parameter infor- 
mation %x are stored intact in uninterpreted form. 
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The final section is the string table. It contains all the values of string capabili- 
ties referenced in the string section. Each string is null terminated. 

Note that it is possible for setupterm to expect a different set of capabilities 
than are actually present in the file. Either the database may have been 
updated since setupterm has been recompiled (resulting in extra unrecognized 
entries in the file) or the program may have been recompiled more recently 
than the database was updated (resulting in missing entries). The routine 
setupterm must be prepared for both possibilities — this is why the numbers 
and sizes are included. Also, new capabilities must always be added at the end 
of the lists of boolean, number, and string capabilities. 

As an example, an octal dump of the description for the Microterm ACT 4 is 
included: 

microterm|act4jmicroterm act iv, 

cr="M, cudl^'J, ind='J, bel—'G, am, cubl="H, 
ed='^_, el-"^ clear-'L, cup-"T%pl%c%p2%c, 
cols#80, lines#24, cufl='X, cuul— "Z, home^"], 



000 


032 


001 




\0 


025 


\0 


\b 


\0 


212 


\0 




\0 


m 


i 


c 


r 


020 


o 


t 


e 


r 


m 




a 


c 


t 


4 




m 


i 


c 


r 


o 


040 


t 


e 


r 


m 




a 


c 


t 




i 


V 


\0 


\0 


001 


\0 


\0 


060 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


\0 


100 


\0 


\0 


P 


\0 


377 


377 


030 


\0 


377 


377 


377 


377 


377 


377 


377 


377 


120 


377 


377 


377 


377 


\0 


\0 


002 


\0 


377 


377 


377 


377 


004 


\0 


006 


\0 


140 


\b 


\0 


377 


377 


377 


377 


\n 


\0 


026 


\0 


030 


\0 


377 


377 


032 


\0 


160 


377 


377 


377 


377 


034 


\0 


377 


377 


036 


\0 


377 


377 


377 


377 


377 


377 


200 


377 


377 


377 


377 


377 


377 


377 


377 


377 


377 


377 


377 


377 


377 


377 


377 


«- 

520 


377 


377 


377 


377 




\0 


377 


377 


377 


377 


377 


377 


377 


377 


377 


377 


540 


377 


377 


377 


377 


377 


377 


007 


\0 


\r 


\0 


\f 


\0 


036 


\0 


037 


\0 


560 


024 


% 


P 


1 


% 


c 


% 


P 


2 


X 


c 


\0 


\n 


\0 


035 


\0 


600 


\b 


\0 


030 


\0 


032 


\0 


\n 


\0 



















Some limitations: total compiled entries cannot exceed 4096 bytes. The name 
field cannot exceed 128 bytes. 

FILES 

/usr/lib/terminfo/*/* compiled terminal capability data base 

SEE ALSO 

curses(3X), terminfo(4). 
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NAME 

terminfo — terminal capability data base 

SYNOPSIS 

/usr/lib/terminfo/*/* 

DESCRIPTION 

Terminfo is a data base describing terminals, used, e.g.,, by v/(l) and 
cursesiyK) . Terminals are described in terminfo by giving a set of capabilities 
which they have, and by describing how operations are performed. Padding 
requirements and initialization sequences are included in terminfo. 

Entries in terminfo consist of a number of ',' separated fields. White space 
after each ',' is ignored. The first entry for each terminal gives the names 
which are known for the terminal, separated by characters. The first name 
given is the most common abbreviation for the terminal, the last name given 
should be a long name fully identifying the terminal, and all others are under- 
stood as synonyms for the terminal name. All names but the last should be in 
lower case and contain no blanks; the last name may well contain upper case 
and blanks for readability. 

Terminal names (except for the last, verbose entry) should be chosen using the 
following conventions. The particular piece of hardware making up the termi- 
nal should have a root name chosen, thus "hp2621". This name should not 
contain hyphens, except that synonyms may be chosen that do not conflict with 
other names. Modes that the hardware can be in, or user preferences, should 
be indicated by appending a hyphen and an indicator of the mode. Thus, a 
vtlOO in 132 column mode would be vtlOO-w. The following suffixes should be 
used where possible: 



Suffix 


Meaning 


Example 


-w 


Wide mode (more than 80 columns) 


vtlOO-w 


-am 


With auto, margins (usually default) 


vtlOO-am 


-nam 


Without automatic margins 


vtlOO-nam 


-n 


Number of lines on the screen 


aaa-60 


-na 


No arrow keys (leave them in local) 


clOO-na 


-np 


Number of pages of memory 


cl00-4p 


-rv 


Reverse video 


clOO-rv 



CAPABILITIES 

The variable is the name by which the programmer (at the terminfo level) 
accesses the capability. The capname is the short name used in the text of the 
database, and is used by a person updating the database. The i.code is the two 
letter internal code used in the compiled database, and always corresponds to 
the old termcap capability name. 

Capability names have no hard length limit, but an informal limit of 5 charac- 
ters has been adopted to keep them short and to allow the tabs in the source 
file caps to line up nicely. Whenever possible, names are chosen to be the same 
as or similar to the ANSI X3.64-1979 standard. Semantics are also intended 
to match those of the specification. 

(P) indicates that padding may be specified 

(G) indicates that the string is passed through tparm withparms as given 
(#0. 

(*) indicates that padding may be based on the number of lines aff"ected 
(#P indicates the / parameter. 
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Variable 


Cap- 


1. 


Description 


Booleans 


name 


Code 




auto_left_margin, 


bw 


bw 


cubl wraps from column 0 to last column 


auto_right_margin. 


am 


am 


Terminal has automatic margins 


beehivejglitch, 


xsb 


xb 


Beehive (.tl=escape, t2=ctrl L,) 


ceol_standoutjglitch, 


xhp 


xs 


Standout not erased by overwritmg (hp; 


eat newline^litch. 


xenl 


xn 


newline ignored after 80 cols (Concept) 


eraseoverstrike, 


eo 


eo 


Can erase overstrikes with a blank 


generic_type, 


gn 


gn 


Generic line type (e.g.,, dialup, switch). 


hard_copy, 


he 


he 


Hardcopy terminal 


has_meta_key, 


km 


km 


Has a meta key (shift, sets parity bit) 


has_status_line, 


hs 


hs 


Has extra "status line" 


insert_null^litch, 


in 


in 


Insert mode distinguishes nulls 


memoryabove, 


da 


da 


Display may be retained above the screen 


memory_below. 


db 


db 


Display may be retained below the screen 


movejnsertmode. 


mir 


mi 


Safe to move while in insert mode 


niove_standout_mode. 


msgr 


ms 


Safe to move in standout modes 


over_strike. 


OS 


OS 


Terminal overstrikes 


status Jine_esc_ok, 


eslok 


es 


Escape can be used on the status line 


teleray_glitch, 


xt 


xt 


Tabs ruin, magic so char (Teleray 1061) 


tilde_glitch. 


hz 


hz 


Hazeltine; can not print ~'s 


transparentunderline, 


ul 


ul 


underline character overstrikes 


xon_xoff, 


xon 


xo 


Termmal uses xon/xon handshakmg 


Numbers: 








columns, 


cols 


CO 


Number of columns in a line 


inittabs, 


it 


it 


Tabs initially every # spaces 


lines, 


lines 


li 


Number of lines on screen or page 


lines_of_memory. 


Im 


Im 


Lines of memory if > lines. 0 means varies 


niagic_cookie_glitch, 


xmc 


sg 


Number of blank chars left by smso or rmso 


padding_baud_rate, 


pb 


pb 


Lowest baud where cr/nl paddmg is needed 


virtual_terminal, 


vt 


vt 


Virtual terminal number (UNIX system) 


widthstatusjine. 


wsl 


ws 


No. columns in status line 


Strings: 








backtab, 


cbt 


bt 


Back tab (P) 


bell, 


bel 


bl 


Audible signal (bell) (P) 


carriage_return, 


cr 


cr 


Carriage return (P*) 


change_scroIl_region, 


csr 


cs 


change to lines #1 through #2 (vtlOO) (PG) 


clear_all_tabs, 


tbc 


ct 


Clear all tab stops (P) 


clear_screen, 


clear 


cl 


Clear screen and home cursor (P*) 


clr_eol. 


el 


ce 


Clear to end of line (P) 


clr_eos, 


ed 


cd 


Clear to end of display (P*) 


column_address. 


hpa 


ch 


Set cursor column (PG) 


command_character. 


cmdch 


CC 


Term, settable cmd char in prototype 


cursor_address, 


cup 


cm 


Screen rel. cursor motion row #1 col #2 (PG) 


cursor_down. 


cudl 


do 


Down one line 


cursor_home. 


home 


ho 


Home cursor (if no cup) 


cursorjnvisible, 


civis 


vi 


Make cursor invisible 


cursorjeft. 


cubl 


le 


Move cursor left one space 


cursor_mem_address, 


mrcup 


CM 


Memory relative cursor addressing 


cursornormal. 


cnorm 


ve 


Make cursor appear normal (undo vs/vi) 


cursorright, 


cufl 


nd 


Non-destructive space (cursor right) 


cursorjojl. 


11 


11 


Last line, first column (if no cup) 


cursorup. 


cuul 


up 


Upline (cursor up) 


cursorvisible. 


cwis 


vs 


Make cursor very visible 


deletecharacter, 


dchl 


dc 


Delete character (P*) 
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deleteline, 


dll 


dl 


Delete line (P*) 


disstatusline, 


dsi 


ds 


Disable status line 


downhalfjine, 


hd 


hd 


Half-hne down (.forward 1/2 hnefeed) 


enteraltcharsetmode, 


smacs 


as 


Start alternate character set (P) 


enterblinkmode, 


blink 


mb 


Turn on blinking 


enterboldmode, 


bold 


md 


Turn on bold (extra bright) mode 


enter ca_mode, 


smcup 


ti 


String to begin programs that use cup 


enterdeletemode, 


smdc 


dm 


Delete mode (enter) 


enter_dim_mode, 


dim 


mh 


Turn on half-bright mode 


enterinsertmode, 


smir 


im 


Insert mode (enter) ; 


enter j)rotected_mode, 


prot 


mp 


Turn on protected mode 


enter_reverse_mode, 


rev 


mr 


Turn on reverse video mode 


enter_secure_niode, 


invis 


mk 


Turn on blank mode (chars invisible) 


enterstandoutmode, 


smso 


so 


Begin stand out mode 


enterunderlinemode. 


smul 


us 


Start underscore mode 


erase_chars 


ech 


ec 


Erase #1 characters (PG) 


exit_alt_charset_mode. 


rmacs 


ae 


End alternate character set (P) 


exit_attribute_mode, 


sgrO 


me 


Turn off all attributes 


exit_ca_mode, 


rmcup 


te 


String to end programs that use cup 


exit_delete_mode, 


rmdc 


ed 


End delete mode 


exitinsertmode, 


rmir 


ei 


End insert mode 


exitstandoutmode, 


rmso 


se 


End stand out mode 


exit underline mode, 


rmul 


ue 


End underscore mode 


flashscreen, 


flash 


vb 


Visible bell (may not move cursor) 


form_feed, 


fi" 


ff 


Hardcopy terminal page eject (P*) 


from_status_line, 


fsl 


fs 


Return from status line 


init_l string, 


isl 


il 


Terminal initialization string 


init_2string, 


is2 


12 


Terminal initialization string 


init_3string, 


is3 


13 


Terminal initialization string 


init_file, 


if 


if 


Name of file containing is 


insert_character, 


ichl 


ic 


Insert character (P) 


insertjine, 


ill 


al 


Add new blank line (P*) 


insert_padding. 


ip 


ip 


Insert pad after character inserted (P*) 


key_backspace, 


kbs 


kb 


Sent by backspace key 


keycatab, 


ktbc 


ka 


Sent by clear-all-tabs key 


key_clear, 


kclr 


kC 


Sent by clear screen or erase key 


key_ctab, 


kctab 


kt 


Sent by clear-tab key 


key_dc. 


kdchl 


kD 


Sent by delete character key 


keydl. 


kdll 


kL 


Sent by delete line key 


key_down, 


kcudl 


kd 


Sent by terminal down arrow key 


keyeic, 


krmir 


kM 


Sent by rmir or smir in insert mode 


key_eol. 


kel 


kE 


Sent by clear-to-end-of-line key 


keyeos, 


ked 


kS 


Sent by clear-to-end-of-screen key 


keyfO, 


kfO 


kO 


Sent by function key fO 


key_f 1 , 


kfl 


kl 


Sent by function key f 1 


key_f 1 0, 


kflO 


ka 


Sent by function key flO 


key_f2, 


kf2 


k2 


Sent by function key f2 


key_f3, 


kf3 


k3 


Sent by function key f3 


key_f4, 


kf4 


k4 


Sent by function key f4 


key_f5, 


kf5 


k5 


Sent by function key f5 


key_f6, 


kf6 


k6 


Sent by function key f6 


key_f7, 


kf7 


k7 


Sent by function key f7 


key to, 


Kto 


K5 


Sent by function key f8 


key_f9. 


kf9 


k9 


Sent by function key f9 


key home. 


khome 


kh 


Sent by home key 


key_ic. 


kichl 


kl 


Sent by ins char/enter ins mode key 


key_il, 


kill 


kA 


Sent by insert line 
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kcubl 


kl 


key 11, 


kll 


kH 




knp 


kN 




kpp 


kP 




kcufi 


kr 


key_sf, 




kF 




kri 


kR 


, .'. 
key stEu, 




WT 

K 1 


key_up. 


kcuul 


KU 


keypsid loc£il, 


rmkx 


ice 


keypsid xmit, 


smlcx 


KS 




11 u 


in 


lah f1 


If 1 

11 1 


1 1 
1 1 


i!ih fin 


If in 
11 i\j 


la 


laD_IZ, 


IfO 


iz 


laU IJ, 


ifi 


ij 




1f4 

n't 


1A 


lab f5, 


lf5 


15 


lab f6, 


lf6 


16 


lab f7 


lf7 


17 

1 / 


laD lo, 


IfR 


IS 
lo 


lab f9, 


lf9 


19 




smm 












nel 




p3.(l ch^r. 


pad 




pdriTi dch, 


dch 


DC 


nflrm H(*lpt(* lint* 


dl 


DL 


pd.rni down cursor, 


ich* 


DO 


Udi. liJ IVrilf 




IC 


parm index, 


indn 


SF 


Lfal 1X1 iiiavi L iillVf 


il 


AL 


p3rni left cursor. 


cub 


LE 


pd.rm right cursor, 


cuf 


RI 


parm rindcx, 


rin 


SR 


l/Cll 111 VUloVJl, 




UP 


pkey key. 


pfkey 




pkey local. 


pfloc 


d1 


pkey xmit, 


pfx 




UllllL oVl 


incO 


ps 


prtr off, 




of 




mc5 


po 


Iw^^ClL Vllul , 


rep 


rp 


reset 1 string. 


rcl 
To 1 


r1 
r 1 


reset 2string, 


rs2 


t2 


reset 3string, 


re"? 


Tj 


f-ACfkf flip 


rf 


rf 


restore cursor, 


rc 


rc 


lUW aUUI Cao, 


vpa 




save cursor. 


sc 


sc 


scroll forward. 


ind 


cf 
SI 








pCl dLiriUUlCa, 


sgr 


sa 


settab, 


hts 


St 


setwindow, 


wind 


wi 


tab, 


ht 


ta 


to_status_line, 


tsl 


ts 



Sent by terminal left arrow key 

Sent by home-down key 

Sent by next-page key 

Sent by previous-page key 

Sent by terminal right arrow key 

Sent by scroli-forward/down key 

Sent by scroll-backward/up key 

Sent by set-tab key 

Sent by terminal up arrow key 

Out of "keypad transmit" mode 

Put terminal in "keypad transmit" mode 



Labels 


on 


function 


key 


fO if not fO 


Labels 


on 


function 


key 


f 1 if not f 1 


Labels 


on 


function 


key 


flO if not flO 


Labels 


on 


function 


key 


f2 if not f2 


Labels 


on 


function 


key 


f3 if not f3 


Labels 


on 


function 


key 


f4 if not f4 


Labels 


on 


function 


key 


f5 if not f5 


Labels 


on 


function 


key 


f6 if not f6 


Labels 


on 


function 


key 


f7 if not f7 


Labels 


on 


function 


key 


f8 if not f8 


Labels 


on 


function 


key 


f9 if not f9 



Turn on "meta mode" (8th bit) 

Turn off "meta mode" 

Newline (behaves like cr followed by If) 

Pad character (rather than null) 

Delete #1 chars (PG*) 

Delete #1 lines (PG*) 

Move cursor down #1 lines (PG*) 

Insert #1 blank chars (PG*) 

Scroll forward #1 lines (PG) 

Add #1 new blank lines (PG*) 

Move cursor left #1 spaces (PG) 

Move cursor right #1 spaces (PG*) 

Scroll backward #1 lines (PG) 

Move cursor up #1 lines (PG*) 

Prog funct key #1 to type string #2 

Prog funct key #1 to execute string #2 

Prog funct key #1 to xmit string #2 

Print contents of the screen 

Turn off the printer 

Turn on the printer 

Repeat char #1 #2 times. (PG*) 

Reset terminal completely to sane modes. 

Reset terminal completely to sane modes. 

Reset terminal completely to sane modes. 

Name of file containing reset string 

Restore cursor to position of last sc 

Vertical position absolute (set row) (PG) 

Save cursor position (P) 

Scroll text up (P) 

Scroll text down (P) 

Define the video attributes (PG9) 

Set a tab in all rows, current column 

Current window is lines #l-#2 cols #3-#4 

Tab to next 8 space hardware tab stop 

Go to status line, column #1 
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initjjrog, 

key_a 1 , 

key_a3, 

key_b2, 

key_cl, 

key_c3, 

prtr_non, 



underlinechar, 
uphalfline, 



uc 



iprog 

kal 

ka3 

kb2 

kcl 

kc3 



hu 



mc5p 



uc 



hu 

iP 

Kl 

K3 

K2 

K4 

K5 



pO 



Underscore one char and move past it 

Half-line up (reverse 1/2 linefeed) 

Path name of program for init 

Upper left of keypad 

Upper right of keypad 

Center of keypad 

Lower left of keypad 

Lower right of keypad 

Turn on the printer for #1 bytes 



A Sample Entry 

The following entry, which describes the Concept— 100, is among the more 
complex entries in the terminfo file as of this writing. 

concept 1 0 0 I c 1 0 0 I concept I c104 I c100-4p I concept 10 0, 

am, bel = ^G, blank = \EH, blink = \EC, clear = ''L$<2*> , cnorm = \Ew, 
cols#80, cr="M$<9>, cub1="H, cud1="J, cuf1=\E=, 
cup = \Ea9<p1X' '%*%c%-p2%' 'X + Xc, 

cuu1=\E;, cvvis = \EW, db , dch1=\E''A$< 16»> , dim=\EE, dl 1 =\E"B$<3»> , 
ed=\E"C$<16»> , el=\E"U$< 16> , eo, f lash=\Ek$<20>\EK , ht=\t$<8>, 
il 1 =\E^R$<3«> , in, inds^J, .ind='J$<9>, ip = $<16«>, 
is2=\EU\Ef \E7\E5\E8\El\ENH\EK\E\2 0 0\Eo&\2 0 0\Eo\47\E , 
kbs=^h, kcub1=\E>, kcud1=\E<, kcuf1=\E=, kcuu1=\E;, 
kf1=\E5, kf2=\E6, kf3=\E7, khome=\E? , 

lines#24, mir, pb#9600, prot=\EI, rep=\ErXp1%c%p2X' 'X+Xc$<.2*>, 

rev=\ED, rmcup=\Ev $<6>\Ep\r\n, rmir=\E\20 0 , rmkx=\Ex, 

rmso=\Ed\Ee, rmul=\Eg, rmul=\Eg, sgrO=\EN\200 , 

smcup = \EU\Ev 8p\Ep\r, smir = \E^P, smkx = \EX, sinso = \EE\ED , 

smul = \EG, tabs, ul , vt#8 , xenl , 

Entries may continue onto multiple lines by placing white space at the begin- 
ning of each line except the first. Comments may be included on lines begin- 
ning with "#". Capabilities in terminfo are of three types: Boolean capabilities 
which indicate that the terminal has some particular feature, numeric capabili- 
ties giving the size of the terminal or the size of particular delays, and string 
capabilities, which give a sequence which can be used to perform particular ter- 
minal operations. 

Types of Capabilities 

All capabilities have names. For instance, the fact that the Concept has 
automatic margins (i.e., an automatic return and linefeed when the end of a 
line is reached) is indicated by the capability am. Hence the description of the 
Concept includes am. Numeric capabilities are followed by the character '#' 
and then the value. Thus cols, which indicates the number of columns the ter- 
minal has, gives the value '80' for the Concept. 

Finally, string valued capabilities, such as el (clear to end of line sequence) are 
given by the two-character code, an '=', and then a string ending at the next 
following A delay in milliseconds may appear anywhere in such a capabil- 
ity, enclosed in $<..> brackets, as in el=\EK$<3>, and padding characters 
are supplied by tputs to provide this delay. The delay can be either a number, 
e.g., '20', or a number followed by an '*', i.e., '3*'. A '*' indicates that the 
padding required is proportional to the number of lines affected by the opera- 
tion, and the amount given is the per-affected-unit padding required. (In the 
case of insert character, the factor is still the number of lines affected. This is 
always one unless the terminal has xenl and the software uses it.) When a '*' is 
specified, it is sometimes useful to give a delay of the form '3.5' to specify a 
delay per unit to tenths of milliseconds. (Only one decimal place is allowed.) 
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A number of escape sequences are provided in the string valued capabilities for 
easy encoding of characters there. Both \E and \e map to an ESCAPE charac- 
ter, 'x maps to a control-x for any appropriate x, and the sequences \n \I \r \t 
\b \f \s give a newline, linefeed, return, tab, backspace, formfeed, and space. 
Other escapes include \'" for \\ for \, \, for comma, \: for :, and \0 for null. 
(\0 will produce \200, which does not terminate a string but behaves as a null 
character on most terminals.) Finally, characters may be given as three octal 
digits after a \. 

Sometimes individual capabilities must be commented out. To do this, put a 
period before the capability name. For example, see the second ind in the 
example above. 

Preparing Descriptions 

We now outline how to prepare descriptions of terminals. The most effective 
way to prepare a terminal description is by imitating the description of a simi- 
lar terminal in terminfo and to build up a description gradually, using partial 
descriptions with vi to check that they are correct. Be aware that a very 
unusual terminal may expose deficiencies in the ability of the terminfo file to 
describe it or bugs in vi. To easily test a new terminal description you can set 
the environment variable TERMINFO to a pathname of a directory containing 
the compiled description you are working on and programs will look there 
rather than in lusr/liblterminfo. To get the padding for insert line right (if the 
terminal manufacturer did not document it) a severe test is to edit /etc/passwd 
at 9600 baud, delete 16 or so lines from the middle of the screen, then hit the 
'u' key several times quickly. If the terminal messes up, more padding is usu- 
ally needed. A similar test can be used for insert character. 

Basic Capabilities 

The number of columns on each line for the terminal is given by the cols 
numeric capability. If the terminal is a CRT, then the number of lines on the 
screen is given by the lines capability. If the terminal wraps around to the 
beginning of the next line when it reaches the right margin, then it should have 
the am capability. If the terminal can clear its screen, leaving the cursor in the 
home position, then this is given by the clear string capability. If the terminal 
overstrikes (rather than clearing a position when a character is struck over) 
then it should have the os capability. If the terminal is a printing terminal, 
with no soft copy unit, give it both he and os. (os applies to storage scope ter- 
minals, such as TEKTRONIX 4010 series, as well as hard copy and APL termi- 
nals.) If there is a code to move the cursor to the left edge of the current row, 
give this as cr. (Normally this will be carriage return, control M.) If there is a 
code to produce an audible signal (bell, beep, etc) give this as bel. 

If there is a code to move the cursor one position to the left (such as back- 
space) that capability should be given as cubl. Similarly, codes to move to the 
right, up, and down should be given as cufl, cuul, and cudl. These local cursor 
motions should not alter the text they pass over, for example, you would not 
normally use 'cufl= ' because the space would erase the character moved over. 

A very important point here is that the local cursor motions encoded in ter- 
minfo are undefined at the left and top edges of a CRT terminal. Programs 
should never attempt to backspace around the left edge, unless bw is given, and 
never attempt to go up locally off the top. In order to scroll text up, a program 
will go to the bottom left corner of the screen and send the ind (index) string. 

To scroll text down, a program goes to the top left corner of the screen and 
sends the ri (reverse index) string. The strings ind and ri are undefined when 
not on their respective corners of the screen. 
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Parameterized versions of the scrolling sequences are indn and rin which have 
the same semantics as ind and ri except that they take one parameter, and 
scroll that many lines. They are also undefined except at the appropriate edge 
of the screen. 

The am capability tells whether the cursor sticks at the right edge of the screen 
when text is output, but this does not necessarily apply to a cufl from the last 
column. The only local motion which is defined from the left edge is if bw is 
given, then a cubl from the left edge will move to the right edge of the previ- 
ous row. If bw is not given, the effect is undefined. This is useful for drawing 
a box around the edge of the screen, for example. If the terminal has switch 
selectable automatic margins, the terminfo file usually assumes that this is on; 
i.e., am. If the terminal has a command which moves to the first column of the 
next line, that command can be given as nel (newline). It does not matter if 
the command clears the remainder of the current Hne, so if the terminal has no 
cr and If it may still be possible to craft a working nel out of one or both of 
them. 

These capabilities suffice to describe hardcopy and glass-tty terminals. Thus 
the model 33 teletype is described as 

33 I tty33 ! tty I model 33 teletype, 

bel = ^G, cols#72, cr = '^M, cudls^J, he, ind=''J, os , 
while the Lear Siegler ADM— 3 is described as 
adm3 I 3 ! Isi adin3 , 

am, bel = '^G, clear='^Z, cols#80, crs^M, cub1 = '^H, cud1 = '^J, 
ind=^J, lines#24, 

Parameterized Strings 

Cursor addressing and other strings requiring parameters in the terminal are 
described by a parameterized string capability, with printf (3S) like escapes % x 
in it. For example, to address the cursor, the cup capability is given, using two 
parameters: the row and column to address to. (Rows and columns are num- 
bered from zero and refer to the physical screen visible to the user, not to any 
unseen memory.) If the terminal has memory relative cursor addressing, that 
can be indicated by mrcup. 

The parameter mechanism uses a stack and special % codes to manipulate it. 
Typically a sequence will push one of the parameters onto the stack and then 
print it in some format. Often more complex operations are necessary. 

The % encodings have the following meanings: 



%% 


outputs '%' 


%d 


print popO as in printf 


%2d 


print popO like %2d 


%3d 


print popO like %3d 


%02d 




%03d 


as in printf 


%c 


print popO gives %c 


%s 


print popO gives %s 


%p[l-9] 


push ith parm 


%P[a-z] 


set variable [a-z] to popO 


%g[a-z] 


get variable [a-z] and push it 


%'c' 


char constant c 


%{nn} 


integer constant nn 


%+ %- %* %/ %m 





arithmetic (%m is mod): push (pop 0 op popO) 
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%& %| %" 
%= %> %< 
%! %- 
%i 



bit operations: push(pop() op popO) 
logical operations: push(pop() op popO) 
unary operations push (op popO) 
add 1 to first two parms (for ANSI terminals) 



%? expr %t thenpart %e elsepart %; 



if-then-else, %e elsepart is optional, 
else-ifs are possible ala Algol 68: 



%? Cj %t bj %e C2 %t bj %e %t b3 %e %t b^ %e %; 
c. are conditions, b- are bodies. 



Binary operations are in postfix form with the operands in the usual order. 
That is, to get x-5 one would use "%gx%{5}%-". 

Consider the Hewlett-Packard 2645, which, to get to row 3 and column 12, 
needs to be sent \E&al2c03Y padded for 6 milliseconds. Note that the order 
of the rows and columns is inverted here, and that the row and column are 
printed as two digits. Thus its cup capability is cup=6\E&%p2%2dc%pl%2dY. 

The Microterm ACT-IV needs the current row and column sent preceded by a 
*T, with the row and column simply encoded in binary, cup=*T%pl%c%p2%c. 
Terminals which use %c need to be able to backspace the cursor (cubl), and to 
move the cursor up one line on the screen (cuul). This is necessary because it 
is not always safe to transmit \n "D and \r, as the system may change or dis- 
card them. (The library routines dealing with terminfo set tty modes so that 
tabs are never expanded, so \t is safe to send. This turns out to be essential for 
the Ann Arbor 4080.) 

A final example is the LSI ADM-3a, which uses row and column offset by a 
blank character, thus cup-\E-%pl%' '%-H%c%p2%' '%-l-%c. After sending 
'\E=', this pushes the first parameter, pushes the ASCII value for a space (32), 
adds them (pushing the sum on the stack in place of the two previous values) 
and outputs that value as a character. Then the same is done for the second 
parameter. More complex arithmetic is possible using the stack. 

If the terminal has row or column absolute cursor addressing, these can be 
given as single parameter capabilities hpa (horizontal position absolute) and vpa 
(vertical position absolute). Sometimes these are shorter than the more general 
two parameter sequence (as with the hp2645) and can be used in preference to 
cup . If there are parameterized local motions (e.g., move n spaces to the right) 
these can be given as cud, cub, cuf, and cuu with a single parameter indicating 
how many spaces to move. These are primarily useful if the terminal does not 
have cup, such as the TEKTRONIX 4025. 

Cursor Motions 

If the terminal has a fast way to home the cursor (to very upper left corner of 
screen) then this can be given as home; similarly a fast way of getting to the 
lower left-hand corner can be given as 11; this may involve going up with cuul 
from the home position, but a program should never do this itself (unless II 
does) because it can make no assumption about the effect of moving up from 
the home position. Note that the home position is the same as addressing to 
(0,0): to the top left corner of the screen, not of memory. (Thus, the \EH 
sequence on Hewlett-Packard terminals cannot be used for home.) 

Area Clears 

If the terminal can clear from the current position to the end of the line, leav- 
ing the cursor where it is, this should be given as el. If the terminal can clear 
from the current position to the end of the display, then this should be given as 
ed. Ed is only defined from the first column of a line. (Thus, it can be simu- 
lated by a request to delete a large number of lines, if a true ed is not 
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available.) 
Insert/delete line 

If the terminal can open a new blank line before the line where the cursor is, 
this should be given as ill; this is done only from the first position of a line. 
The cursor must then appear on the newly blank line. If the terminal can 
delete the line which the cursor is on, then this should be given as dll; this is 
done only from the first position on the line to be deleted. Versions of ill and 
dll which take a single parameter and insert or delete that many lines can be 
given as il and dl. If the terminal has a settable scrolling region (like the 
vtlOO) the command to set this can be described with the csr capability, which 
takes two parameters: the top and bottom lines of the scrolling region. The 
cursor position is, alas, undefined after using this command. It is possible to 
get the effect of insert or delete line using this command — the so and re (save 
and restore cursor) commands are also useful. Inserting lines at the top or bot- 
tom of the screen can also be done using ri or ind on many terminals without a 
true insert/delete line, and is often faster even on terminals with those features. 

If the terminal has the ability to define a window as part of memory, which all 
commands affect, it should be given as the parameterized string wind. The four 
parameters are the starting and ending lines in memory and the starting and 
ending columns in memory, in that order. 

If the terminal can retain display memory above, then the da capability should 
be given; if display memory can be retained below, then db should be given. 
These indicate that deleting a line or scrolling may bring non-blank lines up 
from below or that scrolling back with ri may bring down non-blank lines. 

Insert/Delete Character 

There are two basic kinds of intelligent terminals with respect to insert/delete 
character which can be described using terminfo. The most common 
insert/delete character operations affect only the characters on the current line 
and shift characters off the end of the line rigidly. Other terminals, such as the 
Concept 100 and the Perkin Elmer Owl, make a distinction between typed and 
untyped blanks on the screen, shifting upon an insert or delete only to an 
untyped blank on the screen which is either eliminated, or expanded to two 
untyped blanks. You can determine the kind of terminal you have by clearing 
the screen and then typing text separated by cursor motions. Type abc def 
using local cursor motions (not spaces) between the abc and the def. Then 
position the cursor before the abc and put the terminal in insert mode. If typ- 
ing characters causes the rest of the line to shift rigidly and characters to fall 
off the end, then your terminal does not distinguish between blanks and 
untyped positions. If the abc shifts over to the def which then move together 
around the end of the current line and onto the next as you insert, you have the 
second type of terminal, and should give the capability in, which stands for 
insert null. While these are two logically separate attributes (one line vs. mul- 
tiline insert mode, and special treatment of untyped spaces) we have seen no 
terminals whose insert mode cannot be described with the single attribute. 

Terminfo can describe both terminals which have an insert mode, and terminals 
which send a simple sequence to open a blank position on the current line. 
Give as smir the sequence to get into insert mode. Give as rmir the sequence to 
leave insert mode. Now give as ichl any sequence needed to be sent just before 
sending the character to be inserted. Most terminals with a true insert mode 
will not give ichl; terminals which send a sequence to open a screen position 
should give it here. (If your terminal has both, insert mode is usually prefer- 
able to ichl. Do not give both unless the terminal actually requires both to be 
used in combination.) If post insert padding is needed, give this as a number of 
milliseconds in ip (a string option). Any other sequence which may need to be 
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sent after an insert of a single character may also be given in ip. If your termi- 
nal needs both to be placed into an 'insert mode' and a special code to precede 
each inserted character, then both smir/rmir and ichl can be given, and both 
will be used. The ich capability, with one parameter, n, will repeat the effects 
of ichl n times. 

It is occasionally necessary to move around while in insert mode to delete char- 
acters on the same line (e.g., if there is a tab after the insertion position). If 
your terminal allows motion while in insert mode you can give the capability 
mir to speed up inserting in this case. Omitting mir will affect only speed. 
Some terminals (notably Datamedia's) must not have mir because of the way 
their insert mode works. 

Finally, you can specify dchl to delete a single character, dch with one parame- 
ter, n, to delete n characters, and delete mode by giving smdc and rmdc to 
enter and exit delete mode (any mode the terminal needs to be placed in for 
dchl to work). 

A command to erase n characters (equivalent to outputting n blanks without 
moving the cursor) can be given as ech with one parameter. 

Highlighting, Underlining, and Visible Bells 

If your terminal has one or more kinds of display attributes, these can be 
represented in a number of different ways. You should choose one display form 
as standout mode, representing a good, high contrast, easy-on-the-eyes, format 
for highlighting error messages and other attention getters. (If you have a 
choice, reverse video plus half-bright is good, or reverse video alone.) The 
sequences to enter and exit standout mode are given as smso and rmso, respec- 
tively. If the code to change into or out of standout mode leaves one or even 
two blank spaces on the screen, as the TVI 912 and Teleray 1061 do, then xmc 
should be given to tell how many spaces are left. 

Codes to begin underlining and end underlining can be given as smul and rmul 
respectively. If the terminal has a code to underline the current character and 
move the cursor one space to the right, such as the Microterm Mime, this can 
be given as uc. 

Other capabilities to enter various highlighting modes include blink (blinking) 
bold (bold or extra bright) dim (dim or half-bright) invis (blanking or invisible 
text) prot (protected) rev (reverse video) sgrO (turn off all attribute modes) 
smacs (enter alternate character set mode) and rmacs (exit alternate character 
set mode). Turning on any of these modes singly may or may not turn off 
other modes. 

If there is a sequence to set arbitrary combinations of modes, this should be 
given as sgr (set attributes), taking 9 parameters. Each parameter is either 0 
or 1, as the corresponding attribute is on or off. The 9 parameters are, in 
order: standout, underline, reverse, blink, dim, bold, blank, protect, alternate 
character set. Not all modes need be supported by sgr, only those for which 
corresponding separate attribute commands exist. 

Terminals with the "magic cookie" glitch (xmc) deposit special "cookies" when 
they receive mode-setting sequences, which affect the display algorithm rather 
than having extra bits for each character. Some terminals, such as the 
Hewlett-Packard 2621 , automatically leave standout mode when they move to a 
new line or the cursor is addressed. Programs using standout mode should exit 
standout mode before moving the cursor or sending a newline, unless the msgr 
capability, asserting that it is safe to move in standout mode, is present. 

If the terminal has a way of flashing the screen to indicate an error quietly (a 
bell replacement) then this can be given as flash; it must not move the cursor. 
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If the cursor needs to be made more visible than normal when it is not on the 
bottom line (to make, for example, a non-blinking underline into an easier to 
find block or blinking underline) give this sequence as cvvis. If there is a way 
to make the cursor completely invisible, give that as civis. The capability 
cnorm should be given which undoes the effects of both of these modes. 

If the terminal needs to be in a special mode when running a program that uses 
these capabilities, the codes to enter and exit this mode can be given as smcup 
and rmcup. This arises, for example, from terminals like the Concept with 
more than one page of memory. If the terminal has only memory relative cur- 
sor addressing and not screen relative cursor addressing, a one screen-sized win- 
dow must be fixed into the terminal for cursor addressing to work properly. 
This is also used for the TEKTRONIX 4025, where smcup sets the command 
character to be the one used by terminfo. 

If your terminal correctly generates underlined characters (with no special 
codes needed) even though it does not overstrike, then you should give the 
capability ul. If overstrikes are erasable with a blank, then this should be indi- 
cated by giving eo. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are pressed, 
this information can be given. Note that it is not possible to handle terminals 
where the keypad only works in local (this applies, for example, to the 
unshifted Hewlett-Packard 2621 keys). If the keypad can be set to transmit or 
not transmit, give these codes as smkx and rmkx. Otherwise the keypad is 
assumed to always transmit. The codes sent by the left arrow, right arrow, up 
arrow, down arrow, and home keys can be given as kcubl, kcufl, kcuul, kcudl, 
and khome respectively. If there are function keys such as fO, fl, flO, the 
codes they send can be given as kfO, kfl, kflO. If these keys have labels 
other than the default fO through flO, the labels can be given as IfO, Ifl, 
IflO. The codes transmitted by certain other special keys can be given: kll 
(home down), kbs (backspace), ktbc (clear all tabs), kctab (clear the tab stop 
in this column), kclr (clear screen or erase key), kdchl (delete character), kdll 
(delete line), krmir (exit insert mode), kel (clear to end of line), Red (clear to 
end of screen), kichl (insert character or enter insert mode), kill (insert line), 
knp (next page), kpp (previous page), kind (scroll forward/down), kri (scroll 
backward/up), khts (set a tab stop in this column). In addition, if the keypad 
has a 3 by 3 array of keys including the four arrow keys, the other five keys 
can be given as kal, ka3, kb2, kcl, and kc3. These keys are useful when the 
effects of a 3 by 3 directional pad are needed. 

Tabs and Initialization 

If the terminal has hardware tabs, the command to advance to the next tab 
stop can be given as ht (usually control I). A "backtab" command which 
moves leftward to the next tab stop can be given as cbt. By convention, if the 
teletype modes indicate that tabs are being expanded by the computer rather 
than being sent to the terminal, programs should not use ht or cbt even if they 
are present, since the user may not have the tab stops properly set. If the ter- 
minal has hardware tabs which are initially set every n spaces when the termi- 
nal is powered up, the numeric parameter it is given, showing the number of 
spaces the tabs are set to. This is normally used by the tset command to deter- 
mine whether to set the mode for hardware tab expansion, and whether to set 
the tab stops. If the terminal has tab stops that can be saved in nonvolatile 
memory, the terminfo description can assume that they are properly set. 

Other capabilities include isl, is2, and is3, initialization strings for the termi- 
nal, iprog, the path name of a program to be run to initialize the terminal, and 
if, the name of a file containing long initialization strings. These strings are 



- 11 - 



TERMINFO(4) 



TERMINFO (4) 



expected to set the terminal into modes consistent with the rest of the terminfo 
description. They are normally sent to the terminal, by the tset program, each 
time the user logs in. They will be printed in the following order: isl; is2; set- 
ting tabs using tbc and hts; if; running the program iprog; and finally is3. Most 
initialization is done with isl. Special terminal modes can be set up without 
duplicating strings by putting the common sequences in is2 and special cases in 
isl and is3. A pair of sequences that does a harder reset from a totally unk- 
nown state can be analogously given as rsl, rs2, rf, and rs3, analogous to is2 
and if. These strings are output by the reset program, which is used when the 
terminal gets into a wedged state. Commands are normally placed in rs2 and 
rf only if they produce annoying effects on the screen and are not necessary 
when logging in. For example, the command to set the vtlOO into 80-column 
mode would normally be part of Is2, but it causes an annoying glitch of the 
screen and is not normally needed since the terminal is usually already in 80 
column mode. 

If there are commands to set and clear tab stops, they can be given as tbc 
(clear all tab stops) and hts (set a tab stop in the current column of every 
row). If a more complex sequence is needed to set the tabs than can be 
described by this, the sequence can be placed in is2 or if. 

Delays 

Certain capabilities control padding in the teletype driver. These are primarily 
needed by hard copy terminals, and are used by the tset program to set teletype 
modes appropriately. Delays embedded in the capabilities cr, ind, cubl, ff, and 
tab will cause the appropriate delay bits to be set in the teletype driver. If pb 
(padding baud rate) is given, these values can be ignored at baud rates below 
the value of pb. 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then this 
can be given as pad. Only the first character of the pad string is used. 

If the terminal has an extra "status line" that is not normally used by software, 
this fact can be indicated. If the status line is viewed as an extra line below 
the bottom line, into which one can cursor address normally (such as the 
Heathkit hl9's 25th line, or the 24th line of a vtlOO which is set to a 23-line 
scrolling region), the capability hs should be given. Special strings to go to the 
beginning of the status line and to return from the status line can be given as 
tsl and fsl. (fsl must leave the cursor position in the same place it was before 
tsi. If necessary, the sc and rc strings can be included in tsl and fsl to get this 
effect.) The parameter tsl takes one parameter, which is the column number of 
the status line the cursor is to be moved to. If escape sequences and other spe- 
cial commands, such as tab, work while in the status line, the flag eslok can be 
given. A string which turns off the status line (or otherwise erases its contents) 
should be given as dsl. If the terminal has commands to save and restore the 
position of the cursor, give them as sc and rc. The status line is normally 
assumed to be the same width as the rest of the screen, e.g., cols. If the status 
line is a different width (possibly because the terminal does not allow an entire 
line to be loaded) the width, in columns, can be indicated with the numeric 
parameter wsl. 

If the terminal can move up or down half a line, this can be indicated with hu 
(half-line up) and hd (half-line down). This is primarily useful for superscripts 
and subscripts on hardcopy terminals. If a hardcopy terminal can eject to the 
next page (form feed), give this as Iff (usually control L). 

If there is a command to repeat a given character a given number of times (to 
save time transmitting a large number of identical characters) this can be 
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indicated with the parameterized string rep. The first parameter is the charac- 
ter to be repeated and the second is the number of times to repeat it. Thus, 
tparm(repeat_char, 'x', 10) is the same as 'xxxxxxxxxx'. 

If the terminal has a settable command character, such as the TEKTRONIX 
4025, this can be indicated with cmdch. A prototype command character is 
chosen which is used in all capabilities. This character is given in the cmdch 
capability to identify it. The following convention is supported on some UNIX 
systems: The environment is to be searched for a CC variable, and if found, all 
occurrences of the prototype character are replaced with the character in the 
environment variable. 

Terminal descriptions that do not represent a specific kind of known terminal, 
such as switch, dialup, patch, and network, should include the gn (generic) 
capability so that programs can complain that they do not know how to talk to 
the terminal. (This capability does not apply to virtual terminal descriptions 
for which the escape sequences are known.) 

If the terminal uses xon/xoff handshaking for flow control, give xon. Padding 
information should still be included so that routines can make better decisions 
about costs, but actual pad characters will not be transmitted. 

If the terminal has a "meta key" which acts as a shift key, setting the 8th bit 
of any character transmitted, this fact can be indicated with km. Otherwise, 
software will assume that the 8th bit is parity and it will usually be cleared. If 
strings exist to turn this "meta mode" on and off, they can be given as smm 
and rmm. 

If the terminal has more lines of memory than will fit on the screen at once, 
the number of lines of memory can be indicated with Im. A value of lm#0 
indicates that the number of lines is not fixed, but that there is still more 
memory than fits on the screen. 

If the terminal is one of those supported by the UNIX system virtual terminal 
protocol, the terminal number can be given as vt. 

Media copy strings which control an auxiliary printer connected to the terminal 
can be given as mcO: print the contents of the screen, mc4: turn off the printer, 
and mc5: turn on the printer. When the printer is on, all text sent to the termi- 
nal will be sent to the printer. It is undefined whether the text is also displayed 
on the terminal screen when the printer is on. A variation mc5p takes one 
parameter, and leaves the printer on for as many characters as the value of the 
parameter, then turns the printer off. The parameter should not exceed 255. 
All text, including mc4, is transparently passed to the printer while an mc5p is 
in effect. 

Strings to program function keys can be given as pfkey, pfloc, and pfx. Each of 
these strings takes two parameters: the function key number to program (from 
0 to 10) and the string to program it with. Function key numbers out of this 
range may program undefined keys in a terminal dependent manner. The 
difference between the capabilities is that pfkey causes pressing the given key 
to be the same as the user typing the given string; pfloc causes the string to be 
executed by the terminal in local; and pfx causes the string to be transmitted to 
the computer. 
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Glitches and Braindamage 

Hazeltine terminals, which do not allow characters to be displayed should 
indicate hz. 

Terminals which ignore a linefeed immediately after an am wrap, such as the 
Concept and vtlOO, should indicate xenl. 

If el is required to get rid of standout (instead of merely writing normal text on 
top of it), xhp should be given. 

Teleray terminals, where tabs turn all characters moved over to blanks, should 
indicate xt (destructive tabs). This glitch is also taken to mean that it is not 
possible to position the cursor on top of a "magic cookie", that to erase stan- 
dout mode it is instead necessary to use delete and insert line. 

The Beehive Superbee, which is unable to correctly transmit the escape or con- 
trol C characters, has xsb, indicating that the fl key is used for escape and f2 
for control C. (Only certain Superbees have this problem, depending on the 
ROM.) 

Other specific terminal problems may be corrected by adding more capabilities 
of the form xjc. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being just like the 
other with certain exceptions. The string capability use can be given with the 
name of the similar terminal. The capabilities given before use override those 
in the terminal type invoked by use. A capability can be cancelled by placing 
xx@ to the left of the capability definition, where xx is the capability. For 
example, the entry 

2621-nl, smkx@, rmkx@, use=2621, 

defines a 2621-nl that does not have the smkx or rmkx capabilities, and hence 
does not turn on the function key labels when in visual mode. This is useful for 
different modes for a terminal, or for different user preferences. 

FILES 

/usr/lib/terminfo/?/* files containing terminal descriptions 

SEE ALSO 

cursesOX), printf(3S), term(5). 

tic(lM) in the UNIX System V Administrator Reference Manual. 
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NAME 



utmp, wtmp — utmp and wtmp entry formats 



SYNOPSIS 

#include <sys/types.h> 
#include <utinp.h> 

DESCRIPTION 

These files, which hold user and accounting information for such commands as 
who (I), writeil), and login (\), have the following structure as defined by 
<utnip.h>: 

#define UTMP_FILE Vetc/utmp" 
#define WTMP_FILE Vetc/wtmp" 
#define ut name ut user 



struct utmp { 

char 

char 

char 

short 

short 

struct 
short 
short 

} ut exit; 



ut_user[8l; 

ut_id[4]; 

ut_line[12]; 

utjjid; 

uttype; 

exit status { 

etermination; 

e_exit; 



timet uttime; 



/* User login name */ 

/* /etc/inittab id (usually line #) ♦/ 

/* device name (console, Inxx) */ 

/* process id */ 

/♦ type of entry */ 

/* Process termination status */ 
/* Process exit status */ 
/* The exit status of a process 
♦ marked as DEAD PROCESS. */ 
/* time entry was made */ 



/* Definitions for ut type */ 



#define EMPTY 0 

#define RUN_LVL 1 

#define BOOT_TIME 2 

#define OLD_TIME 3 

#define NEW_TIME 4 

#define INIT_PROCESS 5 /* Process spawned by "init" */ 

#define LOGIN_PROCESS 6 /* A "getty" process waiting for login •/ 

#define USER_PROCESS 7 /* A user process */ 

#define DEAD_PROCESS 8 

#define ACCOUNTING 9 

#define UTMAXTYPE ACCOUNTING /* Largest legal value of ut type */ 



/* Special strings or formats used in the "ut line" field when */ 

/ * accounting for something other than a process */ 

/* No string for the utjine field can be more than 1 1 chars + ♦/ 

/* a NULL in length ♦/ 

#define RUNLVL_MSG "run-level %c" 

#define BOOT_MSG "system boot" 

#define OTIME_MSG "old time" 

#define NTIME_MSG "new time" 
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FILES 

/ usr/ include/ utmp. h 

/etc/utmp 

/etc/wtmp 

SEE ALSO 

getutOC). 

login(l), who(l), write(l) in the UNIX System V User Reference Manual. 
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NAME 

intro — introduction to miscellany 
DESCRIPTION 

This section describes miscellaneous facilities such as macro packages, charac- 
ter set tables, etc. 
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NAME 

ascii — map of ASCII character set 

SYNOPSIS 

cat /usr /pub /ascii 

DESCRIPTION 

Ascii is a map of the ASCII character set, giving both octal and hexadecimal 



equivalents of each character, to be printed as needed 


It contains: 






looo 


nu 1 


001 


soh 


002 


s tx 


003 


etx 


004 


eot 


005 


enq 


006 


ack 


007 


bel 


010 


bs 


01 1 


ht 


012 


nl 


013 


vt 


014 


np 


015 


cr 


016 


so 


017 


s i 


020 


die 


021 


del 


022 


dc2 


023 


de3 


024 


dc4 


025 


nak 


026 


syn 


027 


etb 


1 030 


can 


03 1 


em 


032 


sub 


033 


esc 


034 


f s 


035 


gs 


036 


r s 


037 


us 


040 


sp 


041 


1 


042 




043 


# 


044 


$ 


045 


% 


046 


& 


047 


r 


050 


( 


051 


) 


052 


* 


053 


+ 


054 




055 


- 


056 




057 


1 


060 


0 


061 


1 


062 


2 


063 


3 


064 


4 


065 


5 


066 


6 


067 


1 


070 


8 


|071 


9 


072 




073 




074 


< 


075 


^ 


076 


> 


077 


9 


100 


@ 


101 


A 


102 


B 


103 


C 


104 


D 


105 


E 


106 


F 


107 


G 


110 


H 


111 


I 


112 


J 


113 


K 


114 


L 


115 


M 


116 


N 


117 


0 


120 


P 


121 


Q 


1 122 


R 


123 


S 


124 


T 


125 


U 


126 


V 


127 


W 


130 


X 


1 131 


Y 


132 


Z 


133 


[ 


134 


\ 


135 


] 


136 




137 


_ 


1 140 




1 141 


a 


142 


b 


143 


c 


144 


d 


145 


e 


146 


f 


147 


g 


150 


h 


i 151 


i 


152 


j 


153 


k 


154 


1 


155 


m 


156 


n 


157 


0 


160 


P 


1 161 


q 


162 


r 


163 


s 


164 


t 


165 


u 


166 


V 


167 


w 


1 170 


X 


1 171 


y 


172 


z 


173 


{ 


174 


1 


175 


} 


176 


- 


177 


del 


1 00 


nu 1 


1 01 


soh 


I 02 


stx 


03 


etx 


04 


eot 


05 


enq 


06 


ack 


07 


bel 


08 


bs 


1 09 


ht 


Oa 


nl 


Ob 


vt 


Oe 


np 


Od 


cr 


Oe 


so 


Of 


s i 


1 10 


die 


1 11 


del 


12 


de2 


13 


de3 


14 


dc4 


15 


nak 


16 


syn 


17 


etb 


18 


can 


19 


em 


la 


sub 


lb 


esc 


Ic 


fs 


Id 


gs 


le 


rs 


If 


us 


20 


sp 


21 


! 


22 




23 


# 


24 


$ 


25 


% 


26 


& 


27 


r 


1 28 


( 


29 


) 


2a 


* 


2b 


+ 


2c 




2d 




2e 




2f 


1 


30 


0 


31 


1 


32 


2 


33 


3 


34 


4 


35 


5 


36 


6 


37 


7 


38 


8 


t 39 


9 


3a 




3b 




3e 


< 


3d 




3e 


> 


3f 


? 


40 


@ 


1 41 


A 


42 


B 


43 


C 


44 


D 


45 


E 


46 


F 


47 


G 


1 48 


H 


49 


I 


4a 


J 


4b 


K 


4c 


L 


4d 


M 


4e 


N 


4f 


O 


1 50 


P 


51 


Q 


52 


R 


53 


S 


54 


T 


55 


U 


56 


V 


57 


W 


58 


X 


59 


Y 


5a 


Z 


5b 


[ 


5c 


\ 


5d 


] 


5e 




5f 




60 




61 


a 


62 


b 


63 


c 


64 


d 


65 


e 


66 


f 


67 


g 


1 68 


h 


69 


i 


6a 


j 


6b 


k 


6e 


1 


6d 


m 


6e 


n 


6f 


0 


1 70 


P 


71 


q 


72 


r 


73 


s 


74 


t 


75 


u 


76 


V 


77 


w 


1 78 


X 


79 


y 


7a 


z 


7b 


{ 


7c 




7d 


} 


7e 




7f 


del 



FILES 

/usr/pub/ascii 
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NAME 

environ — user environment 
DESCRIPTION 

An array of strings called the "environment" is made available by exec (2) 
when a process begins. By convention, these strings have the form 
"name^n'alue". The following names are used by various commands: 

PATH The sequence of directory prefixes that shil), timed), nice (I), 
nohupiX), etc., apply in searching for a file known by an incomplete 
path name. The prefixes are separated by colons (:). Loginil) sets 
PATH - :^^n:/usr/b^n. 

HOME Name of the user's login directory, set by loginil) from the password 
file passwd (4) . 

TERM The kind of terminal for which output is to be prepared. This informa- 
tion is used by commands, such as mmil) or tplotilG), which may 
exploit special capabilities of that terminal. 

TZ Time zone information. The format is xxxnzzz where xxx is standard 
local time zone abbreviation, n is the difference in hours from GMT, 
and zzz is the abbreviation for the daylight-saving local time zone, if 
any; for example, EST5EDT. 

Further names may be placed in the environment by the export command and 
"name—value" arguments in shi\), or by exec (2). It is unwise to conflict with 
certain shell variables that are frequently exported by .profile files: MAIL, PSl, 
PS2, IPS. 

SEE ALSO 

exec (2). 

env(l), login(l), sh(l), mm(l), nice(l), nohup(l), time(l), tplot(lG) in the 
UNIX System V User Reference Manual. 
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NAME 

fcntl — file control options 

SYNOPSIS 

#include <fcntLh> 

DESCRIPTION 

The fcntl (2) function provides for control over open files. This include file 
describes requests and arguments to fcntl and openil). 

I* Flag values accessible to open (2) and fcntl (2) */ 
/* (The first three can only be set by open) ♦/ 
#define 0_RDONLY 0 
#define 0_WRONLY 1 
#define 0_RDWR 2 

#define 0_NDELAY 04 /* Non-blocking I/O ♦/ 

#define O APPEND 010 /* append (writes guaranteed at the end) */ 



/* Flag values accessible only to open (2) ♦/ 

#define O CREAT 00400 /* open with file create (uses third open arg)*/ 
#define 0_TRUNC 01000 /* open with truncation */ 
#define 0_EXCL 02000 /• exclusive open */ 



/* fcntl (2) requests 


♦/ 






#define 


F_DUPFD 


0 


/* 


Duplicate fildes */ 


#define 


F_GETFD 


1 


/* 


Get fildes flags */ 


#define 


F_SETFD 


2 


/* 


Set fildes flags */ 


#define 


F_GETFL 


3 


/* 


Get file flags */ 


#define 


F_SETFL 


4 


/* 


Set file flags */ 



SEE ALSO 

fcntl (2), open (2). 
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NAME 

math — math functions and constants 

SYNOPSIS 

#include <math.h> 

DESCRIPTION 

This file contains declarations of all the functions in the Math Library 
(described in Section 3M), as well as various functions in the C Library (Sec- 
tion 3C) that return floating-point values. 

It defines the structure and constants used by the matherr (3M) error-handling 
mechanisms, including the following constant used as an error-return value: 

HUGE The maximum value of a single-precision floating-point 

number. 

The following mathematical constants are defined for user convenience: 
M E The base of natural logarithms (e) . 

M_LOG2E The base-2 logarithm of e. 

M_LOG10E The base- 10 logarithm of e. 

M_LN2 The natural logarithm of 2. 

M LNIO The natural logarithm of 10. 

M PI Tf, the ratio of the circumference of a circle to its diame- 

ter. (There are also several fractions of ir, its reciprocal, 
and its square root.) 

M_SQRT2 The positive square root of 2. 

M_SQRT1_2 The positive square root of 1/2. 

For the definitions of various machine-dependent "constants," see the descrip- 
tion of the <values.h> header file. 



FILES 



/ usr/include/math.h 



SEE ALSO 

intro(3), matherr(3M), values(5). 
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NAME 

prof — profile within a function 

SYNOPSIS 

#define MARK 
#include <prof.h> 

void MARK (name) 

DESCRIPTION 

MARK will introduce a mark called name that will be treated the same as a 
function entry point. Execution of the mark will add to a counter for that mark, 
and program-counter time spent will be accounted to the immediately preced- 
ing mark or to the function if there are no preceding marks within the active 
function. 

Name may be any combination of up to six letters, numbers or underscores. 
Each name in a single compilation must be unique, but may be the same as 
any ordinary program symbol. 

For marks to be effective, the symbol MARK must be defined before the header 
file <prof.h> is included. This may be defined by a preprocessor directive as 
in the synopsis, or by a command line argument, i.e: 



cc -p -DMARK foo.c 



If MARK is not defined, the Af^/?A:(name) statements may be left in the source 
files containing them and will be ignored. 

EXAMPLE 

In this example, marks can be used to determine how much time is spent in 
each loop. Unless this example is compiled with MARK defined on the com- 
mand line, the marks are ignored. 



#include <prof.h> 

foo( ) 
{ 

int i, j; 



MARK (loop I); 

for (i = 0; i < 2000; i+-f-) { 



MARK(loop2); 

for (j = 0; j < 2000; j++) { 



} 



SEE ALSO 

profil(2), monitor (3C). 

prof(l) in the UNIX System V User Reference Manual. 
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NAME 

regexp — regular expression compile and match routines 

SYNOPSIS 

#define INIT < declarations > 
#define GETCO <getc code> 
#define PEEKCO <peekc code> 
#define UNGETC(c) <ungetc code> 
#define RETURN (pointer) < return code> 
#define ERROR (val) < error code> 

#include <regexp.h> 

char •compile (instring, expbuf, endbuf, eof) 
cliar •instring, •expbuf, •endbuf; 
int eof; 

int step (string, expbuf) 
char •string, •expbuf; 

extern char *locl, •loc2, •Iocs; 

extern int circf, sed, nbra; 

DESCRIPTION 

This page describes general-purpose regular expression matching routines in the 
form of ed(l), defined in /usr/include/regexp.h. Programs such as edil), 
sedil), grepil), bs il), expril), etc., which perform regular expression match- 
ing use this source file. In this way, only this file need be changed to maintain 
regular expression compatibility. 

The interface to this file is unpleasantly complex. Programs that include this 
file must have the following five macros declared before the 
"#include <regexp.h>" statement. These macros are used by the compile 
routine. 

GETCO 



PEEKCO 



UNGETC(c) 



RETURN (pointer) 



ERROR (vfl/) 



Return the value of the next character in the regular 
expression pattern. Successive calls to GETCO should 
return successive characters of the regular expression. 

Return the next character in the regular expression. 
Successive calls to PEEKCO should return the same 
character (which should also be the next character 
returned by GETCO). 

Cause the argument c to be returned by the next call to 
GETCO (and PEEKCO). No more that one character 
of pushback is ever needed and this character is 
guaranteed to be the last character read by GETCO. 
The value of the macro UNGETC(c) is always ignored. 

This macro is used on normal exit of the compile rou- 
tine. The value of the argument pointer is a pointer to 
the character after the last character of the compiled 
regular expression. This is useful to programs which 
have memory allocation to manage. 

This is the abnormal return from the compile routine. 
The argument val is an error number (see table below 
for meanings). This call should never return. 
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ERROR 



MEANING 



11 
16 
25 
36 
41 
42 
43 
44 
45 
46 
49 
50 



Range endpoint too large. 
Bad number. 
"\digit" out of range. 
Illegal or missing delimiter. 
No remembered search string. 
\( \) imbalance. 
Too many \(. 

More than 2 numbers given in \{ \}- 
} expected after \. 

First number exceeds second in \{ \}. 
[ 1 imbalance. 

Regular expression overflow. 



The syntax of the compile routine is as follows: 

compile (instring, expbuf, endbuf, eof) 

The first parameter instring is never used explicitly by the compile routine but 
is useful for programs that pass down different pointers to input characters. It 
is sometimes used in the INIT declaration (see below). Programs which call 
functions to input characters or have characters in an external array can pass 
down a value of ((char *) 0) for this parameter. 

The next parameter expbuf is a character pointer. It points to the place where 
the compiled regular expression will be placed. 

The parameter endbuf is one more than the highest address where the compiled 
regular expression may be placed. If the compiled expression cannot fit in 
{endbuf— expbuf) bytes, a call to ERROR (50) is made. 

The parameter eof is the character which marks the end of the regular expres- 
sion. For example, in edil), this character is usually a /. 

Each program that includes this file must have a #define statement for INIT. 
This definition will be placed right after the declaration for the function com- 
pile and the opening curly brace ({). It is used for dependent declarations and 
initializations. Most often it is used to set a register variable to point the 
beginning of the regular expression so that this register variable can be used in 
the declarations for GETCO, PEEKCO and UNGETCO. Otherwise it caa be 
used to declare external variables that might be used by GETCO, PEEKCO and 
UNGETCO. See the example below of the declarations taken from grepi.\). 

There are other functions in this file which perform actual regular expression 
matching, one of which is the function step. The call to step is as follows: 

step (string, expbuf) 

The first parameter to step is a pointer to a string of characters to be checked 
for a match. This string should be null terminated. 

The second parameter expbuf is the compiled regular expression which was 
obtained by a call of the function compile. 

The function step returns non-zero if the given string matches the regular 
expression, and zero if the expressions do not match. If there is a match, two 
external character pointers are set as a side effect to the call to step. The vari- 
able set in step is loci. This is a pointer to the first character that matched 
the regular expression. The variable loc2, which is set by the function advance, 
points to the character after the last character that matches the regular expres- 
sion. Thus if the regular expression matches the entire line, loci will point to 
the first character of string and loc2 will point to the null at the end of string. 
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Step uses the external variable circf which is set by compile if the regular 
expression begins with If this is set then step will try to match the regular 
expression to the beginning of the string only. If more than one regular expres- 
sion is to be compiled before the first is executed the value of circf should be 
saved for each compiled expression and circf should be set to that saved value 
before each call to step. 

The function advance is called from step with the same arguments as step. 
The purpose of step is to step through the string argument and call advance 
until advance returns non-zero indicating a match or until the end of string is 
reached. If one wants to constrain string to the beginning of the line in all 
cases, step need not be called; simply call advance. 

When advance encounters a • or \{ \} sequence in the regular expression, it 
will advance its pointer to the string to be matched as far as possible and will 
recursively call itself trying to match the rest of the string to the rest of the 
regular expression. As long as there is no match, advance will back up along 
the string until it finds a match or reaches the point in the string that initially 
matched the • or \{ \}. It is sometimes desirable to stop this backing up before 
the initial point in the string is reached. If the external character pointer Iocs 
is equal to the point in the string at sometime during the backing up process, 
advance will break out of the loop that backs up and will return zero. This is 
used by ed{\) and sed{\) for substitutions done globally (not just the first 
occurrence, but the whole line) so, for example, expressions like s/y*//g do not 
loop forever. 

The additional external variables sed and nbra are used for special purposes. 
EXAMPLES 

The following is an example of how the regular expression macros and calls 
look from grepd): 

#define IN IT 
#define GETCO 
#define PEEKCO 
#define UNGETC(c) 
#define RETURN (c) 
#define ERROR (c) 

#include <regexp.h> 

(void) compile (♦argv, expbuf, &expbuf[ESIZE], ^0'); 

if (stepdinebuf, expbuf)) 

succeedO; 

FILES 

/usr/include/regexp.h 
SEE ALSO 

bs(l), ed(l), expr(l), grep(l), sed(l) in the UNIX System V User Reference 
Manual. 

BUGS 

The handling of circf is kludgy. 

The actual code is probably easier to understand than this manual page. 



register char 'sp = mstrmg; 

(*sp-l-+) 

(*sp) 

(— sp) 

return; 

regerrO 
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NAME 

Stat — data returned by stat system call 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/stat.h> 

DESCRIPTION 

The system calls stat and fstat return data whose structure is defined by this 
include file. The encoding of the field st mode is defined in this file also. 

/* 

* Structure of the result of stat 
*/ 

struct stat 
{ 

devt stdev; 

inot stino; 

ushort stmode; 

short stnlink; 

ushort stuid; 

ushort stjgid; 

devt strdev; 

ofTt st_size; 

timet statime; 

timet st_mtime; 

time t St ctime; 

}; 



#define 


S 


IFMT 


0170000 


/* 


type of file »/ 


#define 


S. 


IFDIR 


0040000 


/* 


directory */ 


#define 


s. 


JFCHR 


0020000 


/• 


character special */ 


#define 


S 


IFBLK 


0060000 


/* 


block special */ 


#define 


s 


IFREG 


0100000 


/• 


regular ♦/ 


#define 


s' 


I FIFO 


0010000 


/* 


fifo ♦/ 


#define 


s 


ISUID 


04000 


/• 


set user id on execution */ 


#define 


S 


ISGID 


02000 


/* 


set group id on execution */ 


#define 


s_ 


ISVTX 


01000 


/* 


save swapped text even after use •/ 


#define 




.IREAD 


00400 


/• 


read permission, owner */ 


#define 


S_I WRITE 00200 


/• 


write permission, owner */ 


#define 


S. 


.lEXEC 


00100 


/» 


execute/search permission, owner */ 



FILES 

/ usr/include/ sys/types.h 
/ usr/include/sys/stat.h 

SEE ALSO 

stat (2), types (5). 
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TERM (5) 



NAME 



term — conventional names for terminals 



DESCRIPTION 

These names are used by certain commands (e.g., tabsil), manil) and are 
maintained as part of the shell environment (see sh(l), profile (4), and 
environ (5)) in the variable STERM: 

1520 Datamedia 1520 

1620 DIABLO 1620 and others using the HyType II printer 

1620—12 same, in 12-pitch mode 

2621 Hewlett-Packard 2621 series 

2631 Hewlett-Packard 2631 line printer 

263 1 — c Hewlett-Packard 263 1 line printer - compressed mode 

2631— e Hewlett-Packard 2631 line printer - expanded mode 

2640 Hewlett-Packard 2640 series 

2645 Hewlett-Packard 264n series (other than the 2640 series) 

300 DASI/DTC/GSI 300 and others using the HyType I printer 

300—12 same, in 12-pitch mode 

300s DASI/DTC/GSI 300s 

382 DTC 382 

300s— 12 same, in 12-pitch mode 

3045 Datamedia 3045 

33 TELETYPE® Model 33 KSR 

37 TELETYPE Model 37 KSR 

40-2 TELETYPE Model 40/2 

40-4 TELETYPE Model 40/4 

4540 TELETYPE Model 4540 

3270 IBM Model 3270 

4000a Trendata 4000a 

4014 TEKTRONIX 4014 

43 TELETYPE Model 43 KSR 

450 DASI 450 (same as Diablo 1620) 

450—12 same, in 12-pitch mode 

735 Texas Instruments TI735 and TI725 

745 Texas Instruments TI745 

dumb generic name for terminals that lack reverse 

line-feed and other special escape sequences 
sync generic name for synchronous TELETYPE 

4540-compatible terminals 
hp Hewlett-Packard (same as 2645) 

Ip generic name for a line printer 

tnl200 User Electric TermiNet 1200 
tn300 User Electric TermiNet 300 

Up to 8 characters, chosen from [— a— zO— 9], make up a basic terminal name. 
Terminal sub-models and operational modes are distinguished by suffixes begin- 
ning with a — . Names should generally be based on original vendors, rather 
than local distributors. A terminal acquired from one vendor should not have 
more than one distinct basic name. 

Commands whose behavior depends on the type of terminal should accept argu- 
ments of the form —Tterm where term is one of the names given above; if no 
such argument is present, such commands should obtain the terminal type from 
the environment variable STERM, which, in turn, should contain term. 
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TERM (5) 



SEE ALSO 

profile (4), environ (5). 

man(l), mm(l), nroff(l), tplot(lG), sh(l), stty(l), tabs(l) in the UNIX Sys- 
tem V User Reference Manual. 

BUGS 

This is a small candle trying to illuminate a large, dark problem. Programs 
that ought to adhere to this nomenclature do so somewhat fitfully. 
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NAME 

types — primitive system data types 

SYNOPSIS 

#include <sys/types.b> 

DESCRIPTION 

The data types defined in the include file are used in UNIX system code; some 
data of these types are accessible to user code: 



The form daddrj is used for disk addresses except in an i-node on disk, see 
fs(4). Times are encoded in seconds since 00:00:00 GMT, January 1, 1970. 
The major and minor parts of a device code specify kind and unit number of a 
device and are installation-dependent. Offsets are measured in bytes from the 
beginning of a file. The label J variables are used to save the processor state 
while another process is running. 



typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 



struct { int r[ 1 ]; } • 

long daddrt; 

char * caddr_t; 

unsigned int uint; 

unsigned short ushort; 

ushort ino_t; 

short cntt; 

long timej; 

int label_t[10l; 

short devjt; 

long off_t; 

long paddrt; 

long key_t; 



physadr; 



SEE ALSO 

fs(4). 
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NAME 

values — machine-dependent values 

SYNOPSIS 

#include <values.h> 

DESCRIPTION 

This file contains a set of manifest constants, conditionally defined for particu- 
lar processor architectures. 

The model assumed for integers is binary representation (one's or two's comple- 
ment) , where the sign is represented by the value of the high-order bit. 

BlTSUype) The number of bits in a specified type (e.g., int). 

HI BITS The value of a short integer with only the high-order bit 

set (in most implementations, 0x8000). 

HIBITL The value of a long integer with only the high-order bit 

set (in most implementations, 0x80000000). 

HIBITI The value of a regular integer with only the high-order 

bit set (usually the same as HIBITS or HIBITL). 

MAXSHORT The maximum value of a signed short integer (in most 

implementations, Ox7FFF = 32767). 

MAXLONG The maximum value of a signed long integer (in most 

implementations, 0x7FFFFFFF = 2147483647). 

MAX INT The maximum value of a signed regular integer (usually 

the same as MAXSHORT or MAXLONG). 

MAXFLOAT, LN MAXFLOAT The maximum value of a single-precision 

floating-point number, and its natural loga- 
rithm. 

MAXDOUBLE, LN MAXDOUBLE The maximum value of a double-precision 

floating-point number, and its natural loga- 
rithm. 

MINFLOAT, LN MINFLOAT The minimum positive value of a single- 
precision floating-point number, and its 
natural logarithm. 

MINDOUBLE, LN_MINDOUBLE The niinimum positive value of a double- 
precision floating-point number, and its 
natural logarithm. 

FSIGNIF The number of significant bits in the mantissa of a 

single-precision floating-point number. 

DSIGNIF The number of significant bits in the mantissa of a 

double-precision floating-point number. 

FILES 

/ usr/include/values.h 

SEE ALSO 

intro(3), math(5). 
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NAME 

varargs — handle variable argument list 

SYNOPSIS 

#include <varargs.h> 

vaalist 

va_dcl 

void va_start(pvar) 
va_list pvar; 

type va_arg(pvar, type) 
va_list pvar; 

void va_end(pvar) 
vajist pvar; 

DESCRIPTION 

This set of macros allows portable procedures that accept variable argument 
lists to be written. Routines that have variable argument lists (such as 
pnntfi3S)) but do not use varargs are inherently nonportable, as different 
machines use different argument-passing conventions. 

va_aiist is used as the parameter list in a function header. 

va_dcl is a declaration for va_alist. No semicolon should follow va_dcl. 

vajist is a type defined for the variable used to traverse the list. 

va_start is called to initialize pvar to the beginning of the list. 

va_arg will return the next argument in the list pointed to by pvar. Type is the 
type the argument is expected to be. Different types can be mixed, but it is up 
to the routine to know what type of argument is expected, as it cannot be 
determined at runtime. 

va_end is used to clean up. 

Multiple traversals, each bracketed by vajtart ... vajnd, are possible. 
EXAMPLE 

This example is a possible implementation of execl (2) . 

#include < varargs. h> 
#define MAXARGS 100 

/• execl is called by 

execKfile, argl, arg2, (char •)0); 

«/ 

execl (va_alist) 
va del 

{ 

vajist ap; 
char 'file; 

char •args[MAXARGS]; 
int argno 0; 

va_start(ap); 

file — va_arg(ap, char •); 

while ((args(argno-l-+] — va_arg(ap, char •)) != (char •)0) 

va_end(ap); 

return execv(file, args); 

} 
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SEE ALSO 

exec(2), printf(3S). 

BUGS 

It is up to the calling routine to specify how many arguments there are, since it 
is not always possible to determine this from the stack frame. For example, 
execl is passed a zero pointer to signal the end of the list. Printf can tell how 
many arguments are there by the format. 

It is non-portable to specify a second argument of char, short, or float to 
va_arg, since arguments seen by the called function are not char, short, or 
float. C converts char and short arguments to int and converts float arguments 
to double before passing them to a function. 



INTRODUCTION 



This section describes the UNIX System V error message and suggests appropriate actions and references 
for each. 

Also, there are some messages that have the same meaning, but vary slightly in wording between 
machines. 

Many of the error message entries refer to the system description file and its contents. For more 
information on this file, see Setting Up The UNIX System in the UNIX System Administrator 
Guide. 

The term support organization appears frequently throughout this guide and currently refers to one 
of three groups. These groups are the field service representatives that support the hardware, your 
local software support organization, and/ or UNIX System Customer Service. The group to contact 
should be based on the information given in the action section for each error message. 

Guide Conventions 

The error messages appear in alphabetical order with one entry per page. The table of contents makes 
for easy reference. The format of each error message entry follows the template below. 

Error Message (Processor(s)) 

DESCRIPTION 

This section includes a detailed description of the error message. It may also 
consist of references where further information on the error message can be found. 

ACTION 

This section contains probable causes for each error message, if applicable, and/ or 
corrective action(s) that should be taken to alleviate the problem. Those messages 
that require no action are information-only messages. 

REFERENCES 

This section contains the name(s) of the UNIX system source code module(s) that 
produce the error message. 

Operator Notes 

Some messages are issued repeatedly and therefore, tie up the console and render the system unusable. 
In order to correct the error condition, console messages should be temporarily turned off To do this, 
depress the CNTL key and type the letter O on the console terminal. To re-enable, repeat the above 
procedure. 

Procedures for taking system dumps can be found in the UNIX System Operator Guide. 
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Can't allocate message buffer 

DESCRIPTION 

At system initialization time, it was found that too much memory was 
being allocated for messages. Messages are currently unusable. 

ACTION 

Check the MSGSEG and MSGSSZ entries in the system description file. 
MSGSEG is the number of segments to allocate and MSGSSZ is the size 
each segment should be. The product of the two numbers (MSGSEG 
and MSGSSZ) is the amount of memory to allocate for messages. When 
this amount exceeds the amount of memory currently available in the 
machine, the above message appears during system booting. The system 
size must be reduced by either modifying the above entries or by other 
means. Then a new system must be generated and booted. If the above 
solutions are unacceptable, more memory must be added to the machine. 
For more information on message parameters, see the section 
CONFIGURATION PLANNING in Setting Up The UNIX System in the 
UNIX System Administrator Guide. 

REFERENCES 
os/msg.c 
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DANGER: mfree map overflow #, lost # items at # 

DESCRIPTION 

One of the tables, mapped through the system's malloc (see malloc(3C) 
in the UNIX System Programmer Reference Manual) mechanism, has 
overflowed. The first number indicates the address of the table. By 
searching for this address in the system namelist, the name of the 
malfunctioning table can be discovered. The crash command (see 
crash(lM) in the UNIX System Administrator Reference Manual) may 
also be used to find the name of the table. 

ACTION 

Increase the number of entries currently allocated for the malfunctioning 
table in the system description file. Generate a new system. Boot the 
system. 

REFERENCES 

os/malloc.c 



/dev/swap doesn't match swapdev 
changing to x, y 



DESCRIPTION 

The system was configured so that /dev/swap did not match swapdev as 
defined by conf.c. 

ACTION 

The file /dev/swap is automatically converted to agree with swapdev and 
has a major device number x and a minor device number y. If this is 
not the desired swap area, reset the swap parameters in the system 
description file used by config. See configilM) in the UNIX System 
Administrator Manual. Also refer to the Setting Up the UNIX System 
in the UNIX System Administrator Guide. 

REFERENCES 
main.c 



) 
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Device error on device -type drive #, [ctl #,] (slice #1 

DESCRIPTION 

This message indicates that a hardware error has occurred on a block type device. 
Device-type may be one of the following: 

hard disk, floppy disk, cartridge tape. 

A drive number will only appear if the device-type is the hard disk. 

ACTION 

Contact your support organization. 

REFERENCES 

io/fp.c, io/hd.c, io/fd.c, io/ct.c 
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File table overflow 

DESCRIPTION 

The system file table has overflowed and a new reference (see openil), 
accessil), dupil) in the UNIX System Programmer Reference Manual) 
to a file failed. This means that the system was not created with a large 
enough file table to support the maximum number of open files on the 
system. 

ACTION 

Increase the number of entries currently allocated for the open-file table 
(files) in the system description file. The number of i-node table entries 
may also have to be increased. Generate a new system. Boot the new 
system. 

REFERENCES 
os/fio.c 



iaddress > 2*24 



DESCRIPTION 

When updating a file's i-node on the file system, a block number in the 
i-node was found to be greater than permissible. 

ACTION 

This message indicates a software and/or hardware error. It is usually 
caused by a corrupted file system. To check the state of any file system 
suspected to be corrupted, unmount the file system and check it with the 
fsck command (see fsckiXM) in the UNIX System Administrator 
Reference Manual). If the suspect file system is the root system, the 
system will have to go single user to check it. 

The error can also be generated by new device drivers which have not 
been completely debugged. Also suspect are any standard UNIX system 
device drivers that have been modified without authorization. Check any 
drivers that meet the above criteria. 

If none of the above apply, the error can also be caused by a disk drive 
and/or controller. This could be a memory problem also. Contact your 
support organization. 

REFERENCES 
os/iget.c 



Inode table overflow 



DESCRIPTION 

The system i-node table has overflowed and a new file could not be 
accessed (see openil), created), accessil), and stat(2) in the UNIX 
System Programmer Reference Manual). The i-node table overflow 
message means that the system was not created with a large enough i- 
node table to support the maximum number of open files on the system. 

ACTION 

Increase the number of entries currently allocated for the i-node table 
(i-nodes) in the system description file. Generate a new system. Boot 
the system. 

REFERENCES 
os/iget.c 



) 
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panic: binit 



DESCRIPTION 

The system ran out of page tables while initializing the buffer I/O 
system. The processor has halted. 

ACTION 

Reduce the number of buffers in the system description file. Generate a 
new system. Boot the new system. 

REFERENCES 

os/main.c 
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panic: cannot mount root 



DESCRIPTION 

An error occurred while the system was trying to mount the root file 
system. This error occurs during system startup only. The processor has 
halted. 

ACTION 

Generate a system dump. Check that the disk drive that contains the 
root file system is on-line and available. If the disk is on-line and 
available, replace the disk pack that the root file system resides on. 
Attempt to reboot the system. If the problem still exists, suspect 
memory, disk drive and/or controller problems. Contact your support 
organization. Meanwhile, try to boot from a different disk drive. 

REFERENCES 

os/main.c 



) 
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panic: 10 err in swap 

DESCRIPTION 

An unrecoverable error has occurred during a system swap operation. 
The processor has halted. 

ACTION 

This message indicates an error on the disk pack or a disk drive and/or 
controller problem. The following steps should be taken. Generate a 
system dump. Change the location of the swap device to a different 
section on the current pack or replace the disk pack with another. 

If the problem is alleviated, the error was caused by a bad spot on the 
disk pack. 

If the problem still exists, suspect disk drive and/or controller problems. 
Contact your support organization. Meanwhile, attempt to boot from a 
different disk drive. 

REFERENCES 

io/physio.c 
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panic: lost mem 

DESCRIPTION 

While trying to allocate free page frame numbers, no more could be 
found. The processor has halted. 

ACTION 

Dump and reboot the system. The crash command (see crash(lM) in 
the UNIX System Administrator Reference Manaual) can be used to 
gather more information from the system dump about the nature of the 
problem. 

Probable causes include both software and hardware problems. Check 
any new device drivers that have not been completely debugged. Check 
any UNIX system device drivers that have been modified without 
authorization. Also, check to be sure that the configuration information 
in the system description file is correct. 

If none of the above apply, suspect bad hardware. Contact your support 
organization. 

REFERENCES 

os/page.c 
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panic: no fs 



DESCRIPTION 

The in-core super-block of a mounted file system cannot be found. This 
should never happen. The processor has halted. 

ACTION 

Generate a system dump. Reboot the system. The crash command (see 
crash{.\M) in the UNIX System Administrator Reference Manual) can 
be used to gather more information from the system dump about the 
nature of the problem. 

Probable causes of the error include both software and hardware 
problems. Check the configuration information in the system description 
file to make sure it is correct. Check any device drivers that have not 
been completely debugged. Check any UNIX system device driver that 
has been modified without authorization. 

If none of the above apply, suspect hardware problems with the disk 
drive and/or controller. Contact your support organization. 

REFERENCES 

os/alloc.c 
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panic: no imt 

DESCRIPTION 

A mount point was not found in the system mount table when traversing 
a file system boundary. This should never happen. The processor has 
halted. 

ACTION 

Generate a system dump. Reboot the system. The crash command (see 
crashilM) in the UNIX System Administrator Reference Manual) can 
be used to gather more information from the dump about the nature of 
the problem. 

Probable causes include both software and hardware problems. Check 
the configuration information in the system description file, make sure it 
is correct. Check any new device drivers that have not been completely 
debugged. Also, check any UNIX system device driver that has been 
modified without authorization. 

If none of the above apply, suspect hardware problems with the disk 
drive and/or controller. Contact your support organization. 

REFERENCES 
os/iget.c 



- 13 - 



panic: no procs 



DESCRIPTION 

A process table entry cannot be found during a fork when it is known 
that an entry is available. This should never happen. The processor has 
halted. 

ACTION 

Generate a system dump. Reboot the system. Contact your support 
organization. 



REFERENCES 
fork.c 



panic: Timeout table overflow 

DESCRIPTION 

The system timeout table, which is used to implement software 
interrupts, has overflowed while attempting to add another entry. The 
processor has halted. 

ACTION 

Reboot the system. If this condition persists, increase the number of 
entries currently allocated for the call-out table (calls) in the system 
description file. Generate a new system. Boot the new system. 

REFERENCES 

os/timeout.c 
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on q 

DESCRIPTION 

When making a process ready to run, after the occurrence of a wakeup 
event, the process was found to be already on the system run queue. 
This should never happen. 

ACTION 

If the delivered UNIX operating system is unaltered, contact your 
support organization. 

REFERENCES 
os/slp.c 



real mem » value 
avail mem = value 



DESCRIPTION 

Real memory is the number of bytes of physical memory on the CPU. 
Available memory is the number of bytes of physical memory actually 
available to the user processes. 

ACTION 

This message is for information only. 

REFERENCES 

machdep.c 
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Text table overflow 

DESCRIPTION 

The shared text table has overflowed and a shared text program was not 
allowed to execute. Too many programs with the sticky bit on (ISVTX) 
may be present in the system. This is usually a transient condition that 
occurs under a heavy load. 

ACTION 

If the condition persists, increase the number of entries currently 
allocated for the text table (texts) in the system description file. 
Generate a new system. Boot the system. 

REFERENCES 
os/text.c 



Warning: /dev/swap not found 



DESCRIPTION 

While booting the system, there was no i-node found for /dev/swap. 
Certain commands such as ps (see psil) in the UNIX System User 
Reference Manual) will not work properly without /dev/swap. 

ACTION 

After the system is booted, use /etc/mknod to create an i-node for 
/dev/swap. 

REFERENCES 
main.c 
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panic: bflush: bad free list 

DESCRIPTION 

The linked list of free I/O buffers is corrupt. The processor has halted. 
ACTION 

Generate a system dump. Reboot the system. The crash command (see 
crashilM) in the UNIX System Administrator Reference Manual) can 
be used to gather information from the dump about the nature of the 
problem. 



Probable causes include both software and hardware problems. Check 
any new device drivers that have not been completely debugged. Check 
any UNIX System device drivers that has been modified without 
authorization. Make sure that the configuration information in the 
system description file is correct. 

If none of the above apply, suspect bad hardware and contact your 
support organization. 

REFERENCES 
bio.c 
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